Query Task

Query TaskStatus

GET /v1/platform/tasks/{task_id}

Query the current status and result of an image or video generation task. Recommended polling interval: 2–5 seconds. Tasks typically complete within seconds to minutes.

⚠️ Can only query tasks submitted by the current API Key. Cross-key queries will return 404 TASK_NOT_FOUND。

⚠️ /v1/platform/video and /v1/platform/image File URLs generated are only retained for 7 days. Please download and save them promptly.

Path Parameters

Parameter	Type	Required	Description
task_id	string	Required	The task_id returned when the task was submitted.

Response Parameters

Field Name	Type	Description
task_id	string	Task ID.
object	string	Object type: image tasks use image_task, video tasks use video_task.
model	string	The model field value used when submitting the task.
status	string	Current task status: 可选值：queued / in_progress / success / failed / pending
progress	string	Task progress as a percentage string, e.g. "50%", "100%".
created_at	integer	Task creation time, Unix timestamp (seconds).
completed_at	integer	Task completion time, Unix timestamp (seconds). Only present when status is success or failed.
result	object	Generation result. Only present when status is success. ↳ result child fields
error	object	Error message. Only present when status is failed. ↳ error child fields

result child fields

Field Name	Type	Description
url	string	Primary URL of the generation result (direct link to image or video).
urls	array<string>	List of all generation result URLs, usually the same as url.
type	string	Result type: image or video.

error child fields

Field Name	Type	Description
code	string	Error code, e.g. TASK_FAILED.
message	string	Detailed error description.

Response Example

JSON · Task In Progress

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

JSON · Task Succeeded

{
  "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 Failed

{
  "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":"Content safety check failed, please modify the prompt and retry"
  }
}