mingyan

Sd2 Manxue - Create Task

Create sd2_manxue video generation tasks with standard, fast, and video-reference models

POST/kyyReactApiServer/v1/sd2_manxue/videos

Sd2 Manxue Create Video Task

Create an sd2_manxue video generation task. This API supports text-only generation, first frame mode, first/last frame mode, and multimodal references. If you need to pass referenceVideos, use an sd2_manxue_video_* or sd2_manxue_video_fast_* model.

Authentication

Get Key

All requests require a Bearer token in the request header:

cURL

Authorization: Bearer {{key}}

Base URL

https://zcbservice.aizfw.cn/kyyReactApiServer

baseUrl is the shared prefix for all public APIs. The api field in the current page frontmatter shows the full endpoint. Use this baseUrl as the common prefix when reading or composing request paths.

Request Parameters

promptbodystringrequired

Video generation prompt.

modelbodystringrequired

Model name used to determine the output resolution.

Available values:

sd2_manxue_720p
sd2_manxue_1080p
sd2_manxue_2k
sd2_manxue_4k
sd2_manxue_fast_720p
sd2_manxue_fast_1080p
sd2_manxue_video_720p
sd2_manxue_video_1080p
sd2_manxue_video_2k
sd2_manxue_video_4k
sd2_manxue_video_fast_720p
sd2_manxue_video_fast_1080p

durationbodyinteger

Video duration in seconds. Defaults to 5. Supported range: 4-15.

ratiobodystring

Output aspect ratio. Defaults to 16:9.

Supported values:

21:9
16:9
4:3
1:1
3:4
9:16

first_imagebodystring

First frame image URL.

Rules:

Primary field for first-frame and first/last-frame modes
Can be used alone for first frame mode
When combined with last_image, it becomes first/last frame mode
Compatible with the legacy field image
Cannot be used together with referenceImages, referenceVideos, or referenceAudios

last_imagebodystring

Last frame image URL.

Rules:

Primary field for first/last frame mode
Must be used together with first_image
Compatible with the legacy field lastFrameImage

When both legacy and current fields are provided, first_image and last_image take precedence. Conflicting values return a parameter conflict error.

referenceImagesbodyarray

Reference image URL list.

Rules:

Up to 9 images
Cannot be used together with first_image, last_image, or the legacy fields image, lastFrameImage

referenceVideosbodyarray

Reference video URL list.

Rules:

Supported only by sd2_manxue_video_* and sd2_manxue_video_fast_* models
Up to 3 videos
Total duration must not exceed 15 seconds
Total size must not exceed 500MB
Can be used together with referenceImages and referenceAudios
Cannot be used together with first_image, last_image, or the legacy fields image, lastFrameImage

Standard sd2_manxue_* and sd2_manxue_fast_* models do not support referenceVideos.

referenceAudiosbodyarray

Reference audio URL list.

Rules:

Up to 3 audio files
Total duration must not exceed 15 seconds
Total size must not exceed 500MB
Cannot be used together with first_image, last_image, or the legacy fields image, lastFrameImage

Response Parameters

idstring

Unique identifier for the video generation task, used for subsequent status queries

objectstring

Object type, always video

createdinteger

Task creation timestamp

modelstring

Model name used

statusstring

Task status:

queued - Queued
processing - Processing
completed - Completed
failed - Failed

errorstring

Error message, returned when status is failed

Parameter Rules

last_image cannot be used alone and must be paired with first_image
referenceImages and referenceAudios can be used separately or together
referenceVideos is available only for video-reference models and can be combined with referenceImages and referenceAudios
Any reference* field is mutually exclusive with first_image / last_image

Compatibility:

Legacy fields image and lastFrameImage are still accepted
When both legacy and current fields are provided, current fields take precedence
If both sets are provided with different values, the API returns a parameter conflict error

Model and Resolution

Model	Output Resolution	Recommended Usage
`sd2_manxue_720p`	`720p`	Speed-oriented baseline quality
`sd2_manxue_1080p`	`1080p`	Standard HD generation
`sd2_manxue_2k`	`2k`	Higher-detail video output
`sd2_manxue_4k`	`4k`	Highest quality scenarios
`sd2_manxue_fast_720p`	`720p`	Fast series for speed-priority HD generation
`sd2_manxue_fast_1080p`	`1080p`	Fast series for speed-priority high-definition output
`sd2_manxue_video_720p`	`720p`	Standard video-reference scenarios
`sd2_manxue_video_1080p`	`1080p`	High-definition video-reference scenarios
`sd2_manxue_video_2k`	`2k`	Higher-detail video-reference scenarios
`sd2_manxue_video_4k`	`4k`	Highest-quality video-reference scenarios
`sd2_manxue_video_fast_720p`	`720p`	Fast video-reference series for HD output
`sd2_manxue_video_fast_1080p`	`1080p`	Fast video-reference series for high-definition output

Standard sd2_manxue_* models generate directly at the matching resolution. sd2_manxue_fast_* models are the fast series. sd2_manxue_video_* and sd2_manxue_video_fast_* are dedicated video-reference models for requests that include referenceVideos.