SD2 Manxue: Query Video Generation Task Status and Result

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

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

string

The unique task identifier.

string

Object type. Always "video".

integer

Unix timestamp of when the task was created.

string

The model used for this task (e.g., sd2_manxue_1080p, sd2_manxue_4k, sd2_manxue_fast_720p).

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

string

Temporary download URL for the generated video. Only present when status is "completed". null while the task is pending or processing.

number

Actual output duration of the generated video in seconds. Only present when status is "completed".

string

Error message describing the failure reason. Only present when status is "failed".

Task Status Flow

queued → processing → completed or failed

Status	Meaning
`queued`	Task accepted, waiting to be picked up
`processing`	SD2 Manxue model is generating the video
`completed`	Video ready — retrieve via `video_url`
`failed`	An 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'

import requests
import time

task_id = "video_sd2manxue_1234567890"
headers = {"Authorization": "Bearer YOUR_API_KEY"}

while True:
    response = requests.get(
        f"https://zcbservice.aizfw.cn/kyyReactApiServer/v1/result/{task_id}",
        headers=headers,
    )
    result = response.json()
    status = result["status"]

    print(f"Status: {status}")

    if status == "completed":
        print("Video URL:", result["video_url"])
        print("Actual duration:", result["actualDuration"], "seconds")
        # Download and save the video before the URL expires
        break
    elif status == "failed":
        print("Error:", result["error"])
        break

    time.sleep(30)

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."
}

Overview

Text APIs

Image APIs

Video APIs

Asset Management

SD2 Manxue: Query Video Generation Task Status and Result

Endpoint

Authentication

Path Parameters

Response Fields

Task Status Flow

Polling Advice

Result URL Notes

Code Examples

Example Responses

​Endpoint

​Authentication

​Path Parameters

​Response Fields

​Task Status Flow

​Polling Advice

​Result URL Notes

​Code Examples

​Example Responses

Endpoint

Authentication

Path Parameters

Response Fields

Task Status Flow

Polling Advice

Result URL Notes

Code Examples

Example Responses