• 简体中文
  • 查询状态与下载视频(豆包 / Seedance 格式)

    查询与获取视频生成任务状态使用同一端点,响应为统一任务 JSON(状态流转与字段说明见该页)。SUCCESS 后从 data.result_url 下载视频。

    端点

    GET /v1/video/generations/{task_id}

    请求示例

    建议每 10 秒轮询一次。注意 result_url 为火山 TOS 签名直链,约 24 小时失效,请及时下载转存。

    cURL
    Python
    Node.js
    curl https://api-model.shuntianchuang.cn/v1/video/generations/task_xxxxxxxx \
      -H "Authorization: Bearer sk-你的令牌"

    响应体

    查询响应为统一任务 JSON。其中 data.data 为上游原始任务响应,回显实际生效的参数值——核对参数是否生效以这里为准:

    data.data 字段说明
    seed / ratio / resolution / duration实际生效的生成参数,核对参数是否生效以这里为准
    framespersecond帧率,文生视频固定 24fps
    generate_audio是否生成音频,成功产物带音轨
    usage.completion_tokensSeedance 2.0 系按 token 计费的实际用量;1.0 系计费规则见模型广场
    content.video_url与 data.result_url 相同的视频直链
    content.last_frame_url尾帧图(提交时 return_last_frame: true 才有)

    响应示例

    {
      "code": "success",
      "data": {
        "task_id": "task_xxxxxxxx",
        "status": "SUCCESS",
        "progress": "100%",
        "result_url": "https://xxxx/video.mp4",
        "fail_reason": "",
        "data": {
          "id": "cgt-xxxx",
          "seed": 42,
          "ratio": "16:9",
          "resolution": "1080p",
          "duration": 5,
          "framespersecond": 24,
          "generate_audio": true,
          "output_format": "mp4",
          "usage": { "completion_tokens": 245025, "total_tokens": 245025 },
          "content": {
            "video_url": "https://…/video.mp4",
            "last_frame_url": "https://…/last-frame.png"
          }
        }
      }
    }

    状态回调(可选)

    提交时传 metadata.callback_url(公网可达、可收 POST 的地址)后,上游会在每个状态变化时推送一次 POST:body 为上游任务对象 JSON(含 id、model、status、content 等),按 status 字段判断终态(succeeded / failed)。回调与轮询互不冲突,可同时使用。