mingyanmingyan
wechatwechat
mingyan

StarVideos O3 - Query Task

Query the status and result of StarVideos O3 video generation tasks

GET/kyyReactApiServer/v1/result/{id}

StarVideos O3 Query Video Task

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

Authentication

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
Task ID.
The {id} value comes from the id returned by the create task API.

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. Current value: starvideos_o3.
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

StarVideos O3 is actively generating the video.

completed

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

Polling Recommendations

Polling strategy:
  • Recommended polling interval: 30-60 seconds
  • Stop polling when status becomes completed or failed
  • Result URLs may be temporary, so save them promptly
Important:
  • The {id} path parameter must use the id returned by the create API
  • Generated result URLs are usually temporary, so save them promptly