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 Videos model video generation task and retrieve the output URL once complete. Video generation is asynchronous — after submitting a task via Create Video Task, call 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 (e.g., videos or videos_fast).
​
status
string
Current task status:
  • queued — task is waiting in the processing queue
  • processing — the model 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 processed
processingVideos model is actively generating the video
completedVideo ready — retrieve via video_url
failedAn error occurred — check error for details

​
Polling Advice

Recommended polling interval: 30–60 seconds.Most tasks complete within a few minutes. Tasks using multiple reference images or videos may take longer due to additional processing. Stop polling as soon as status is completed or failed — excessive polling may trigger rate limiting.

​
Result URL Notes

The video_url is a temporary download link. Save the video to your own storage immediately after generation completes — the URL will expire and become inaccessible.
  • Tasks that fail content policy checks will return status: "failed" immediately
  • Tasks with heavier reference media (more images, longer videos) will take longer to complete

​
Code Examples

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

​
Example Responses

While processing: 
{
  "id": "video_1234567890",
  "object": "video",
  "created": 1761635478,
  "model": "videos",
  "status": "processing",
  "video_url": null,
  "error": null
}
On completion: 
{
  "id": "video_1234567890",
  "object": "video",
  "created": 1761635478,
  "model": "videos",
  "status": "completed",
  "video_url": "https://cdn.example.com/video_1234567890.mp4",
  "actualDuration": 5,
  "error": null
}
On failure: 
{
  "id": "video_1234567890",
  "object": "video",
  "created": 1761635478,
  "model": "videos",
  "status": "failed",
  "video_url": null,
  "error": "Reference video exceeds maximum total duration of 15 seconds."
}