> ## Documentation Index
> Fetch the complete documentation index at: https://docs.maxapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 查询任务状态 (官方格式)

> 查询视频生成任务的状态和结果



## OpenAPI

````yaml /api-reference/openapi.json get /seedance/api/v3/contents/generations/tasks/{id}
openapi: 3.0.1
info:
  title: MaxAPI 模型 API
  description: MaxAPI 文本、图像、视频、音频和音乐模型接口。
  version: 1.0.0
servers:
  - url: https://api.maxapi.ai
    description: MaxAPI 生产环境
security: []
tags:
  - name: 模型接口
  - name: 模型接口/绘图模型
  - name: 模型接口/绘图模型/OpenAI Dall-e 格式
  - name: 模型接口/绘图模型/Flux系列
  - name: 模型接口/绘图模型/Flux系列/OpenAI Dalle 格式
  - name: 模型接口/绘图模型/Z-image
  - name: 模型接口/绘图模型/Banana生图异步格式(未来可能兼容其他模型)
  - name: 模型接口/聊天接口（Chat）
  - name: 模型接口/视频模型
  - name: 模型接口/视频模型/谷歌veo
  - name: 模型接口/视频模型/谷歌veo/VertexAI-VEO官方格式
  - name: 模型接口/视频模型/谷歌veo/VertexAI-VEO官方格式/视频生成
  - name: 模型接口/视频模型/谷歌veo/VertexAI-VEO官方格式/任务查询
  - name: 模型接口/视频模型/谷歌veo/AIStudio-VEO官方格式
  - name: 模型接口/视频模型/谷歌veo/AIStudio-VEO官方格式/视频生成
  - name: 模型接口/视频模型/谷歌veo/AIStudio-VEO官方格式/任务查询
  - name: 模型接口/视频模型/谷歌veo/AIStudio-VEO官方格式/下载视频(只有aistudio有这个动作)
  - name: 模型接口/视频模型/谷歌veo/GCP异步任务接口
  - name: 模型接口/视频模型/谷歌veo/官网逆向接口格式
  - name: 模型接口/视频模型/谷歌veo/官网逆向接口格式/视频生成
  - name: 模型接口/视频模型/谷歌veo/官网逆向接口格式/OpenAI官方视频格式(适配 newapi)
  - name: 模型接口/视频模型/Wan阿里万象(官方格式)
  - name: 模型接口/视频模型/豆包seedance(官方格式)
  - name: 模型接口/视频模型/Vidu官方格式
  - name: 模型接口/视频模型/Vidu官方格式/视频生成
  - name: 模型接口/视频模型/Vidu官方格式/图像生成
  - name: 模型接口/视频模型/Vidu官方格式/音频生成
  - name: 模型接口/视频模型/Vidu官方格式/其他功能
  - name: 模型接口/视频模型/Vidu官方格式/任务管理
  - name: 模型接口/视频模型/MiniMax-Hailuo官方格式
  - name: 模型接口/视频模型/MiniMax-Hailuo官方格式/视频生成
  - name: 模型接口/视频模型/MiniMax-Hailuo官方格式/任务管理
  - name: 模型接口/视频模型/MiniMax-Hailuo-OpenAI-Sora兼容格式
  - name: 模型接口/视频模型/MiniMax-Hailuo-OpenAI-Sora兼容格式/视频生成
  - name: 模型接口/视频模型/Sora-2-官方格式
  - name: 模型接口/视频模型/Sora-2-官方格式/创建角色接口
  - name: 模型接口/视频模型/Sora-2026-01-07新格式
  - name: 模型接口/自动补全接口（Completions）
  - name: 模型接口/图像接口（Images）
  - name: 模型接口/向量生成接口（Embeddings）
  - name: 模型接口/音频接口（Audio）
  - name: 模型接口/MJ图像(视频)接口
  - name: 模型接口/MJ图像(视频)接口/InsightFace任务提交
  - name: 模型接口/MJ图像(视频)接口/任务提交
  - name: 模型接口/MJ图像(视频)接口/任务查询
  - name: 模型接口/MJ图像(视频)接口/MJ视频相关
  - name: 模型接口/Suno音乐接口
  - name: 模型接口/Suno音乐接口/GoAmzAI格式
  - name: 模型接口/Suno音乐接口/GoAmzAI格式/v3.5
  - name: 模型接口/Suno音乐接口/GoAmzAI格式/v3.0
  - name: 模型接口/Suno音乐接口/官网原生格式(v2)
  - name: 模型接口/Suno音乐接口/官网原生格式(v2)/所有接口
  - name: 模型接口/Suno音乐接口/官网原生格式(v2)/场景1 生成自定义音乐(带歌词)
  - name: 模型接口/Suno音乐接口/官网原生格式(v2)/场景 2 通过提示词直接生成音乐(带歌词)
  - name: 模型接口/Suno音乐接口/官网原生格式(v2)/场景 4 通过提示词直接生成音乐(纯音乐)
  - name: 模型接口/Suno音乐接口/官网原生格式(v2)/场景3 生成自定义音乐(纯音乐)
  - name: 模型接口/Suno音乐接口/官网原生格式(v2)/场景 5 上传自定义音频并续写
  - name: 模型接口/Suno音乐接口/生成歌词
  - name: 模型接口/Suno音乐接口/NewAPI兼容格式
  - name: 模型接口/Luma视频接口
  - name: 模型接口/Luma视频接口/GoAmzAI格式
  - name: 模型接口/Luma视频接口/GoAmzAI格式/付费版
  - name: 模型接口/Luma视频接口/GoAmzAI格式/免费版
  - name: 模型接口/Luma视频接口/官网原生格式(v2)
  - name: 模型接口/SD图像接口
  - name: 模型接口/SD图像接口/SD3
  - name: 模型接口/SD图像接口/SDXL
  - name: 模型接口/Fish Audio
  - name: 模型接口/统一视频接口
  - name: 模型接口/统一视频接口/阿里Wan(万相视频
  - name: 模型接口/统一视频接口/Sora2视频
  - name: 模型接口/统一视频接口/Seedance(即梦视频
  - name: 模型接口/统一视频接口/Google-Veo
  - name: 历史接口
  - name: 历史接口/PPT类接入
  - name: 历史接口/请求示例
  - name: 历史接口/原始接口（参数需要定义后才能发送请求）
  - name: 佐糖API
  - name: MewXAI星月熊开放API
  - name: MewXAI星月熊开放API/开放API接口
  - name: MewXAI星月熊开放API/示例
  - name: Ideogram（绘画）
  - name: 可灵API
  - name: RunWay官方API
  - name: 视频生成
  - name: 任务查询
  - name: Wan官方格式
  - name: 图像生成
  - name: 音频生成
  - name: 其他功能
  - name: 任务管理
  - name: InsightFace任务提交
  - name: 任务提交
  - name: Generate
  - name: SDXL & SD1.6
paths:
  /seedance/api/v3/contents/generations/tasks/{id}:
    get:
      tags:
        - 模型接口/视频模型/豆包seedance(官方格式)
        - Wan官方格式
      summary: 查询任务状态 (官方格式)
      description: 查询视频生成任务的状态和结果
      operationId: wanOfficialFetchTask
      parameters:
        - name: id
          in: path
          description: ''
          required: true
          schema:
            type: string
      responses:
        '200':
          description: 成功
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WanFetchResponse'
              examples:
                '1':
                  summary: 成功示例
                  value:
                    code: 0
                    message: success
                    data:
                      task_id: task_123456
                      platform: wan
                      action: text_to_video
                      status: SUCCESS
                      submit_time: 1704067200
                      start_time: 1704067205
                      finish_time: 1704067300
                      progress: 100
                      data:
                        video_url: https://example.com/video.mp4
                        prompt: 一只可爱的小猫在草地上玩耍
                        duration: 5
                        resolution: 720P
                '2':
                  summary: 成功示例
                  value:
                    code: success
                    data:
                      action: text_to_video
                      data:
                        actual_prompt: >-
                          日光，晴天光，柔光，侧光，暖色调，中景，中心构图，低角度拍摄。一只毛茸茸的白色小猫在阳光下的草地上翻滚玩耍，它有着圆溜溜的琥珀色眼睛，粉嫩的鼻子和耳朵微微抖动。小猫前爪抱住一根随风轻摆的狗尾草，后腿蹬地用力打转，尾巴高高翘起保持平衡。草叶上露珠闪烁，微风吹过草地泛起层层波浪。背景是蓝天下成片的绿草地，几朵蒲公英随风飘散。小猫突然扑向空中飞舞的蝴蝶，前爪腾空跃起，身体悬停瞬间四爪张开，随后跌进柔软的草丛中打了个滚，仰面朝天蹬着小腿，发出细嫩的“喵呜”声。伴随清脆鸟鸣与远处孩童嬉笑声，环境音中夹杂着草叶摩擦的沙沙声。
                        orig_prompt: 一只可爱的小猫在草地上玩耍
                        output: >-
                          https://dashscope-result-bj.oss-accelerate.aliyuncs.com/1d/4d/20251029/8cce9486/7c6e4a23-897a-4fc3-87e9-8973538a8997.mp4?Expires=1761828346&OSSAccessKeyId=ALIYUN_ACCESS_KEY_ID&Signature=REDACTED
                        usage:
                          video_count: 1
                          video_duration: 5
                          video_ratio: 1920*1080
                      platform: wan
                      progress: 100%
                      status: SUCCESS
                      submit_time: 0
                      task_id: 7c6e4a23-897a-4fc3-87e9-8973538a8997
                    message: ''
          headers: {}
      deprecated: false
      security:
        - BearerAuth: []
components:
  schemas:
    WanFetchResponse:
      type: object
      properties:
        code:
          type: integer
          description: 响应码，0表示成功
        message:
          type: string
          description: 响应消息
        data:
          type: object
          properties:
            task_id:
              type: string
              description: 任务ID
            platform:
              type: string
              description: 平台名称
              example: wan
            action:
              type: string
              description: 任务类型
              enum:
                - text_to_video
                - image_to_video
                - keyframe_to_video
            status:
              type: string
              description: 任务状态
              enum:
                - SUBMITTED
                - IN_PROGRESS
                - SUCCESS
                - FAILURE
            fail_reason:
              type: string
              description: 失败原因(失败时返回)
            submit_time:
              type: integer
              description: 提交时间(Unix时间戳)
            start_time:
              type: integer
              description: 开始时间(Unix时间戳)
            finish_time:
              type: integer
              description: 完成时间(Unix时间戳)
            progress:
              type: integer
              description: 进度(0-100)
              minimum: 0
              maximum: 100
            data:
              type: object
              description: 任务结果数据
              properties:
                video_url:
                  type: string
                  description: 视频URL
                prompt:
                  type: string
                  description: 提示词
                image_url:
                  type: string
                  description: 输入图片URL(图生视频时返回)
                duration:
                  type: integer
                  description: 视频时长(秒)
                resolution:
                  type: string
                  description: 分辨率
                usage:
                  type: object
                  description: 使用量信息
                  properties:
                    duration:
                      type: integer
                      description: 视频时长(秒)
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: 使用 MiniMax API Key 进行认证

````