Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.xingchaoyiqing.com/llms.txt

Use this file to discover all available pages before exploring further.

Use this endpoint to poll the status of a StarVideos O3 video generation task and retrieve the output URL once generation completes. Video generation is asynchronous — submit a task via Create Video Task, then poll this endpoint periodically until status reaches completed or failed.

​
Endpoint

GET /v1/result/{id}

​
Authentication

Authorization: Bearer YOUR_API_KEY

​
Path Parameters

​
id
string
required
The unique task identifier returned by the Create Video Task endpoint. Use the exact value of the id field from the creation response.

​
Response Fields

​
id
string
The unique task identifier.
​
object
string
Object type. Always "video".
​
created
integer
Unix timestamp of when the task was created.
​
model
string
The model used for this task. Always "starvideos_o3".
​
status
string
Current task status:
  • queued — task is waiting in the processing queue
  • processing — StarVideos O3 is actively generating the video
  • completed — generation finished; video_url is populated
  • failed — generation failed; see error for details
​
video_url
string
Temporary download URL for the generated video. Only present when status is "completed". null while the task is pending or processing.
​
actualDuration
number
Actual output duration of the generated video in seconds. Only present when status is "completed".
​
error
string
Error message describing the failure reason. Only present when status is "failed".

​
Task Status Flow

queued → processing → completed or failed
StatusMeaning
queuedTask accepted, waiting to be picked up
processingStarVideos O3 model is generating the video
completedVideo ready — retrieve via video_url
failedAn error occurred — check error for details

​
Polling Advice

Recommended polling interval: 30–60 seconds.Stop polling as soon as status becomes completed or failed. Polling too frequently may trigger rate limiting.

​
Result URL Notes

The video_url is a temporary download link. Download and save the video to your own storage immediately after the task completes — the URL will expire and become inaccessible after a short period.

​
Code Examples

curl --request GET \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/result/video_starvideos_o3_1234567890 \
  --header 'Authorization: Bearer YOUR_API_KEY'

​
Example Responses

While processing: 
{
  "id": "video_starvideos_o3_1234567890",
  "object": "video",
  "created": 1774836724,
  "model": "starvideos_o3",
  "status": "processing",
  "video_url": null,
  "error": null
}
On completion: 
{
  "id": "video_starvideos_o3_1234567890",
  "object": "video",
  "created": 1774836724,
  "model": "starvideos_o3",
  "status": "completed",
  "video_url": "https://cdn.example.com/video_starvideos_o3_1234567890.mp4",
  "actualDuration": 5,
  "error": null
}
On failure: 
{
  "id": "video_starvideos_o3_1234567890",
  "object": "video",
  "created": 1774836724,
  "model": "starvideos_o3",
  "status": "failed",
  "video_url": null,
  "error": "Reference image resolution is too low."
}