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 an SD2 Manxue video generation task and retrieve the output URL once complete. Video generation is asynchronous — submit a task via Create Video Task, then poll this endpoint periodically until status reaches completed or failed. Tasks that include multiple reference images, videos, or audio files may take longer to process.

​
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., sd2_manxue_1080p, sd2_manxue_4k, sd2_manxue_fast_720p).
​
status
string
Current task status:
  • queued — task is waiting in the processing queue
  • processing — the SD2 Manxue 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 picked up
processingSD2 Manxue 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.Most tasks complete within a few minutes. Tasks with more reference media (images, videos, or audio) generally take longer to process. Stop polling as soon as status is 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 generation completes — the URL will expire and become inaccessible after a short period.
  • Higher resolution models (2K, 4K) may have longer generation times than 720p or 1080p models
  • Tasks that fail content policy checks return status: "failed" immediately
  • If you submitted a face or avatar reference image without first going through the asset library, the task may fail — use asset://{assetId} for those images

​
Code Examples

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

​
Example Responses

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