任务查询

使用 GET /v1/tasks/{id} 查询图像、视频或音乐接口创建的任务。

接口地址

GET /v1/tasks/{id}

请求头

Authorization: Bearer YOUR_API_KEY

路径参数

字段	类型	是否必填	说明
`id`	string	必填	生成接口返回的任务 ID。

状态说明

状态	含义
`pending`	任务正在等待开始。
`processing`	任务正在生成中。
`success`	任务已完成，可以读取结果 URL。
`failed`	任务失败，可以查看 `errorMessage`。
`canceled`	任务已取消。

请求示例

curl https://sseedance.com/v1/tasks/task_id \
  -H "Authorization: Bearer YOUR_API_KEY"

返回示例

{
  "object": "task",
  "data": {
    "id": "task_id",
    "mediaType": "image",
    "provider": "yunwu",
    "model": "gpt-image-2-all",
    "prompt": "A premium product photo",
    "status": "success",
    "imageUrls": ["https://cdn.example.com/image.png"],
    "videoUrls": [],
    "audioUrls": [],
    "errorMessage": null
  }
}

结果字段

imageUrls：图像任务的最终图片 URL。
videoUrls：视频任务的最终视频 URL。
audioUrls：音乐任务的最终音频 URL。
errorMessage：任务失败时的人话错误信息。

如果任务还是 pending 或 processing，等待一小段时间后，用同一个任务 ID 再查一次。

任务查询

On this page