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 1.5 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 reaches a terminal state.
Video generation is asynchronous. Continue polling at the recommended interval until status is "completed", "failed", or "cancelled".

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 (e.g. video_abc123def456).

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 1.5 model used for generation (e.g. "seedance_1_5_pro_720p").
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
  • cancelled — task was cancelled before completion
video_url
string
A direct download URL for the generated MP4 video. Only present when status is "completed". Valid for 1 day after generation — download and store the video promptly.
actualDuration
number
The actual output duration of the video in seconds. Only present when status is "completed". Useful when you used duration: -1 (auto).
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 1.5 model is generating the video
3completedVideo is ready; retrieve it via video_url
failedAn error occurred; inspect the error field
cancelledTask was cancelled before generation finished

Polling Recommendations

Choose your polling interval based on the model resolution you used:
ModelRecommended IntervalEstimated Generation Time
seedance_1_5_pro_480p (preview)every 10–20 s30 s – 2 min
seedance_1_5_pro_720pevery 30–60 s2–5 min
seedance_1_5_pro_1080pevery 30–60 s3–8 min
Start with a 480p preview (seedance_1_5_pro_480p) to validate your prompt and composition before generating at 720p or 1080p. This saves time and cost.
  • Stop polling immediately when status is "completed", "failed", or "cancelled".
  • Avoid polling more frequently than every 10 seconds to prevent rate limiting.

Video & Task Retention

Both the task record and the generated video file are retained for only 1 day. After 24 hours, both are permanently deleted and cannot be recovered. Download and save the video to your own storage as soon as generation completes.
  • Format: MP4
  • Retention: 1 day (task ID and video file)

Code Examples

curl --request GET \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/result/video_abc123def456 \
  --header 'Authorization: Bearer YOUR_API_KEY'
Example response — processing:
{
  "id": "video_abc123def456",
  "object": "video",
  "created": 1761635478,
  "model": "seedance_1_5_pro_720p",
  "status": "processing",
  "video_url": null,
  "error": null
}
Example response — completed:
{
  "id": "video_abc123def456",
  "object": "video",
  "created": 1761635478,
  "model": "seedance_1_5_pro_720p",
  "status": "completed",
  "video_url": "https://cdn.example.com/videos/video_abc123def456.mp4",
  "actualDuration": 5,
  "error": null
}