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.

After you create a Seedance 2.0 video generation task, use this endpoint to check its status and retrieve the download URL once generation is complete. Pass the id returned by the Create Video Task endpoint as the path parameter, and keep polling until status is "completed" or "failed".
Video generation is asynchronous. Fast model variants (seedance_2_0_fast, seedance_2_0_fast_pro) typically complete sooner and can be polled at shorter intervals.

​
Endpoint

Base URL:  https://zcbservice.aizfw.cn/kyyReactApiServer
Endpoint:  GET /v1/result/{id}
Full URL:  https://zcbservice.aizfw.cn/kyyReactApiServer/v1/result/{id}
All requests must include your API key as a Bearer token: 
Authorization: Bearer YOUR_API_KEY

​
Path Parameters

​
id
string
required
The unique task identifier returned by the Create Video Task endpoint.Example: video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd

​
Response Fields

​
id
string
Unique identifier of the video generation task.
​
object
string
Object type. Always "video".
​
created
integer
Unix timestamp (seconds) of when the task was created.
​
model
string
The Seedance 2.0 model used for generation. One of: seedance_2_0, seedance_2_0_fast, seedance_2_0_pro, seedance_2_0_fast_pro.
​
status
string
Current task status:
  • queued — task is in the queue, waiting to be processed
  • processing — the model is actively generating the video
  • completed — generation succeeded; video_url is populated
  • failed — generation failed; see error for details
​
video_url
string
A direct download URL for the generated MP4 video. Only present when status is "completed". Valid for 1 day — download and store the video promptly.
​
actualDuration
number
The actual output duration of the video in seconds. Only present when status is "completed".
​
totalTokens
integer
The total number of tokens consumed by this generation task. Only present when status is "completed". Use this value for cost tracking and quota management.
​
error
string
Error message describing why the task failed. Only present when status is "failed".

​
Status Flow

StepStatusMeaning
1queuedTask created and added to the processing queue
2processingSeedance 2.0 model is generating the video
3completedVideo is ready; retrieve it via video_url
—failedAn error occurred; inspect the error field

​
Polling Recommendations

Use a 20–40 second polling interval as the default. For fast model variants, you can shorten this to 10–20 seconds.
ModelRecommended Poll IntervalEstimated Generation Time
seedance_2_0every 20–40 s2–5 min
seedance_2_0_fastevery 10–20 s1–3 min
seedance_2_0_proevery 20–40 s3–6 min
seedance_2_0_fast_proevery 10–20 s2–4 min
  • Stop polling immediately when status is "completed" or "failed".
  • Avoid polling more frequently than every 10 seconds to prevent rate limiting.
Factors that affect generation time:
  • Video duration: longer durations take more time
  • Model type: fast variants generate more quickly
  • Reference media: adding multi-modal references (images, videos, audio) may increase processing time
  • System load: peak usage periods may result in longer queue times

​
Video URL Notes

The video_url is valid for 1 day after the task completes. Download and save the MP4 file to your own storage promptly — the URL cannot be recovered after expiry.
  • Format: MP4
  • Audio: present if generateAudio was true during task creation; silent if false
  • Retention: 1 day

​
Code Examples

curl --request GET \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/result/video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd \
  --header 'Authorization: Bearer YOUR_API_KEY'
Example response — queued: 
{
  "id": "video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd",
  "object": "video",
  "created": 1774836724,
  "model": "seedance_2_0_fast",
  "status": "queued",
  "video_url": null,
  "error": null
}
Example response — completed: 
{
  "id": "video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd",
  "object": "video",
  "created": 1774836724,
  "model": "seedance_2_0_fast",
  "status": "completed",
  "video_url": "https://cdn.example.com/videos/video_fd35ee52.mp4",
  "actualDuration": 8,
  "totalTokens": 1240,
  "error": null
}