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.

Submit an asynchronous video generation task using the SD2 Manxue model family. The endpoint returns a task id immediately — poll the Query Video Task endpoint until the task reaches completed or failed. SD2 Manxue supports pure text-to-video, first-frame and first/last frame guidance, and a rich multi-modal reference mode that accepts images, videos, and audio together. Models range from 720p to 4K output resolution, with Fast variants for speed-sensitive workflows.

​
Base URL

https://zcbservice.aizfw.cn/kyyReactApiServer

​
Endpoint

POST /v1/sd2_manxue/videos

​
Authentication

Authorization: Bearer YOUR_API_KEY

​
Models

Select the model based on your desired output resolution and speed requirements:
ModelOutput ResolutionNotes
sd2_manxue_720p720pStandard quality, faster generation
sd2_manxue_1080p1080pFull HD, general-purpose
sd2_manxue_2k2KHigher-precision output
sd2_manxue_4k4KMaximum quality, highest detail
sd2_manxue_fast_720p720pFast series — speed-first at 720p
sd2_manxue_fast_1080p1080pFast series — speed-first at 1080p
The Fast series (sd2_manxue_fast_*) prioritizes speed over maximum detail. Use the standard series when you need the highest quality for a given resolution.

​
Request Parameters

​
prompt
string
required
Text description of the video content. Include subject, action, camera movement, and visual style.Example: "A woman jogging on a neon-lit street at night, rain reflections, smooth camera push, cinematic"
​
model
string
required
The model to use. Determines output resolution. See the model table above.Supported values: sd2_manxue_720p, sd2_manxue_1080p, sd2_manxue_2k, sd2_manxue_4k, sd2_manxue_fast_720p, sd2_manxue_fast_1080p
​
duration
integer
Output video duration in seconds.
  • Default: 5
  • Supported range: 4–15 seconds
​
ratio
string
Output aspect ratio. Defaults to 16:9.
ValueDescription
16:9Landscape (default)
21:9Ultrawide
4:3Standard screen
1:1Square
3:4Portrait standard
9:16Portrait

​
First / Last Frame Mode

​
first_image
string
URL of the first-frame image.
  • Used alone: drives video from this starting frame
  • Used with last_image: first/last frame guidance mode
  • Accepts public URL or asset://{assetId} for assets submitted via the asset library
  • Recommended image aspect ratio: 0.4–2.5; recommended size: 300–6000 px
  • Cannot be used with referenceImages, referenceVideos, or referenceAudios
​
last_image
string
URL of the last-frame image. Enables first/last frame guidance when paired with first_image.
  • Must be used together with first_image
  • Cannot be used alone
  • Recommended image aspect ratio: 0.4–2.5; recommended size: 300–6000 px
first_image/last_image are mutually exclusive with all reference* fields. You cannot mix frame-guidance mode and reference media mode in the same request.

​
Multi-Modal Reference Mode

Use these fields to provide reference media for the generated video. All three can be combined freely, but none can be combined with first_image or last_image.
​
referenceImages
array
Array of reference image URLs (or asset://{assetId} references).
  • Maximum 9 images
  • Accepted formats: jpeg, png, webp, bmp, tiff, gif
  • Recommended aspect ratio: 0.4–2.5; recommended dimensions: 300–6000 px
  • Cannot be used with first_image or last_image
​
referenceVideos
array
Array of reference video URLs.
  • Maximum 3 videos
  • Total combined duration must not exceed 15 seconds
  • Total combined size must not exceed 500 MB
  • Cannot be used with first_image or last_image
​
referenceAudios
array
Array of reference audio URLs.
  • Maximum 3 audio files
  • Total combined duration must not exceed 15 seconds
  • Total combined size must not exceed 500 MB
  • Cannot be used with first_image or last_image
For images containing faces or virtual avatars, submit the image to the asset library first and reference it using the asset://{assetId} format to ensure optimal results and policy compliance.

​
Legacy Compatibility

The legacy fields image (alias for first_image) and lastFrameImage (alias for last_image) remain supported. If both a legacy field and its new counterpart are provided with conflicting values, the API returns a parameter conflict error.

​
Response Fields

​
id
string
Unique task identifier. Save this value — you’ll use it to poll the Query Video Task endpoint.
​
object
string
Object type. Always "video".
​
created
integer
Unix timestamp of when the task was created.
​
model
string
The model name used for this task.
​
status
string
Task status at creation. Always "queued" on successful submission.Lifecycle values:
  • queued — task accepted and waiting in queue
  • processing — model is actively generating
  • completed — generation finished; video_url is available
  • failed — generation failed; see error
​
error
string
Error message. null on successful submission.

​
Generation Modes

ModeRequired FieldsConstraints
Text-to-videomodel, promptOptional: duration, ratio
First-framemodel, prompt, first_imageOptional: duration, ratio
First/last framemodel, prompt, first_image, last_imageOptional: duration, ratio
Image referencemodel, prompt, referenceImagesUp to 9 images
Video referencemodel, prompt, referenceVideosUp to 3 videos, ≤15s total
Audio referencemodel, prompt, referenceAudiosUp to 3 files, ≤15s total
Multi-modalmodel, prompt + any combination of referenceImages, referenceVideos, referenceAudiosAll reference* can be combined

​
Code Examples

curl --request POST \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/sd2_manxue/videos \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sd2_manxue_1080p",
    "prompt": "A woman jogging on a neon-lit street at night, rain reflections, smooth camera push, cinematic",
    "duration": 5,
    "ratio": "16:9"
  }'

​
Example Response

{
  "id": "video_sd2manxue_1234567890",
  "object": "video",
  "created": 1774836724,
  "model": "sd2_manxue_1080p",
  "status": "queued",
  "error": null
}

​
Next Steps

After receiving the task id, poll the Query Video Task endpoint to check status and retrieve video_url when generation completes.