查询任务

查询任务状态

GET /v1/platform/tasks/{task_id}

查询图像或视频生成任务的当前状态和结果。建议以 2~5 秒为间隔进行轮询，任务通常在数秒到数分钟内完成。

⚠️ 只能查询当前 API Key 所提交的任务。跨 Key 查询将返回 404 TASK_NOT_FOUND。

⚠️ /v1/platform/video 和 /v1/platform/image 生成的文件 URL 仅保留 7 天，请及时下载保存。

路径参数

参数名	类型	必选	说明
task_id	string	必选	提交任务时返回的 task_id。

响应参数

字段名	类型	说明
task_id	string	任务 ID。
object	string	对象类型，图像任务为 image_task，视频任务为 video_task。
model	string	提交任务时使用的 model 字段值。
status	string	任务当前状态： 可选值：queued / in_progress / success / failed / pending
progress	string	任务进度，格式为百分比字符串，例如 "50%"、"100%"。
created_at	integer	任务创建时间，Unix 时间戳（秒）。
completed_at	integer	任务完成时间，Unix 时间戳（秒）。仅当 status 为 success 或 failed 时存在。
result	object	生成结果，仅当 status 为 success 时存在。 ↳ result 子字段
error	object	错误信息，仅当 status 为 failed 时存在。 ↳ error 子字段

result 子字段

字段名	类型	说明
url	string	生成结果的主 URL（图像或视频的直链）。
urls	array<string>	所有生成结果 URL 的列表，通常与 url 相同。
type	string	结果类型，image 或 video。

error 子字段

字段名	类型	说明
code	string	错误代码，例如 TASK_FAILED。
message	string	错误详细描述。

响应示例

JSON · 任务进行中

{
  "task_id":   "vid_abc123xyz456",
  "object":    "video_task",
  "model":     "video-jimeng-3.0pro",
  "status":    "in_progress",
  "progress":  "60%",
  "created_at":1741680000
}

JSON · 任务成功

{
  "task_id":     "vid_abc123xyz456",
  "object":      "video_task",
  "model":       "video-jimeng-3.0pro",
  "status":      "success",
  "progress":    "100%",
  "created_at":  1741680000,
  "completed_at":1741680043,
  "result": {
    "url":  "https://vod-cdn.example.com/output/vid_abc123xyz456.mp4",
    "urls": ["https://vod-cdn.example.com/output/vid_abc123xyz456.mp4"],
    "type": "video"
  }
}

JSON · 任务失败

{
  "task_id":     "vid_abc123xyz456",
  "object":      "video_task",
  "model":       "video-jimeng-3.0pro",
  "status":      "failed",
  "progress":    "0%",
  "created_at":  1741680000,
  "completed_at":1741680005,
  "error": {
    "code":    "TASK_FAILED",
    "message":"内容安全检测不通过，请修改 prompt 后重试"
  }
}