mingyanmingyan
wechatwechat
mingyan

Videos - Query Task

Query the status and result of Videos video generation tasks

GET/kyyReactApiServer/v1/result/{id}

Videos Query Video Task

Use the task ID to query the status and result of a Videos video generation task.

Authentication

Get Key
All requests require a Bearer token in the request header:
cURL
Authorization: Bearer {{key}}

Base URL

https://zcbservice.aizfw.cn/kyyReactApiServer
baseUrl is the shared prefix for all public APIs. The api field in the current page frontmatter shows the full endpoint. Use this baseUrl as the common prefix when reading or composing request paths.

Path Parameters

idstringrequired
Unique identifier of the video generation task, returned by the create task API.
The create API returns the field id directly. Use that value as the id here.

Response Parameters

idstring
Unique identifier of the video generation task.
objectstring
Object type, always video.
createdinteger
Task creation timestamp.
modelstring
Model name used for generation.
statusstring
Task status:
  • queued - Queued
  • processing - Processing
  • completed - Completed
  • failed - Failed
video_urlstring
Generated video URL, returned when the task is completed.
actualDurationnumber
Actual output duration in seconds, returned when the task is completed.
errorstring
Error message, returned when the task is failed.

Status Flow

queued

The task has been created and added to the queue.

processing

The Videos model is actively generating the video.

completed

The task has completed successfully and the result is available through video_url.

Polling Recommendations

Polling Strategy:
  • Recommended polling interval: 30-60 seconds
  • Most tasks complete within a few minutes, but complex reference-heavy scenarios may take longer
  • Avoid aggressive polling to reduce the risk of rate limiting
  • Stop polling when the status becomes completed or failed

Result Notes

The model field in historical task results may reflect the model used when the task was created. New tasks support videos, videos_stable, and videos_stable_fast.
Important:
  • Generated result URLs are usually temporary, so save them promptly
  • Tasks with many image, video, or audio reference materials may take longer to complete; audio references are supported only by videos
  • Invalid prompts or unsupported reference materials may cause task failure