Model CenterGlobalAiOpc

wan3.0-video-r2v-c4

POST/kyyReactApiServer/v2/model-center/tasks

Model information

Field	Value
Model ID (`model`)	`wan3.0-video-r2v-c4`
Model type	Video models
Set the request `model` field to the Model ID shown above. Using the model name will fail to resolve the model.

Authentication

Get Key

All requests must include a Bearer token in the request headers:

cURL

Authorization: Bearer <API_KEY>

Request parameters

Send the following fields in the JSON request body. model is required — use the Model ID from the Model information section above.

promptstringrequired

Prompt

Text prompt input.

Minimum：1

reference_imagesimage[]

Reference images

内部统一参考图片输入；最多 10 张；可与参考视频、音频同时使用

Range：0 – 10

Items：0 - 10

Provide a publicly accessible resource URL.

reference_videosvideo[]

Reference videos

参考视频输入。最多 5 段；全部参考视频总时长不超过 15 秒

Range：0 – 5

Items：0 - 5

Provide a publicly accessible resource URL.

reference_audiosaudio[]

Reference audios

参考音频输入。最多 5 段；具体素材时长、内容和组合由生成服务校验，建议与图片或视频配合

Range：0 – 5

Items：0 - 5

Provide a publicly accessible resource URL.

durationinteger

Duration

Generated video duration.

Range：2 – 30

Default：5

aspect_ratiostring

Aspect ratio

Output aspect ratio.

Allowed values：16:9, 9:16, 1:1, auto, adaptive

resolutionstring

Resolution

Output resolution tier.

Allowed values：480P, 720P, 1080P

Default：720P

seedinteger

Seed

Deterministic generation seed.

Range：0 – 2147483647

first_imageimage[]

First frame

图生视频首帧输入。；不能与普通参考图片、视频、音频混用

Range：0 – 1

Items：0 - 1

Provide a publicly accessible resource URL.

last_imageimage[]

Last frame

视频尾帧约束输入。必须同时有 first_frame，遵守同样的混用限制

Range：0 – 1

Items：0 - 1

Provide a publicly accessible resource URL.

audio_settingstring

Audio setting

Audio policy for video generation or editing.

generate_audioboolean

Generate audio

Whether to generate an audio track.

Default：false

watermarkboolean

Watermark

Whether to add provider or platform watermark.

Default：true

Response contract

Task status is normalized to queued, processing, completed, or failed. Result URLs are returned only when status is completed;

Field	Description
`id`	Task ID used to poll status and results.
`object`	Resource type, usually `video` for this model.
`created`	Task creation time as a Unix timestamp in seconds.
`model`	Model name used for this request.
`status`	`queued`, `processing`, `completed`, or `failed`.
`progress`	Task progress, usually returned by the query API.
`result_url`	Generic result URL, returned only after completion.
`video_url`	Typed result URL for this resource, returned only after completion.
`amount`	Credits consumed by this task.
`actualDuration`	Duration used by this task.
`error_message`	Additional result field exposed by model configuration.
`error`	Error message on failure; usually `null` while queued, processing, or completed.

Query task result

Generation tasks run asynchronously. The submit endpoint returns a task id; poll the query endpoint below with that id until status becomes completed or failed.

http

GET https://zcbservice.aizfw.cn/kyyReactApiServer/v2/model-center/tasks/{id}
Authorization: Bearer <API_KEY>

idstringrequired

The task ID returned by the submit endpoint.

When status is completed, the result URL is returned via result_url and video_url. See the Response contract above for the remaining fields.

Poll every 5–10 seconds and stop once status is completed or failed. Result URLs expire, so download and store them promptly.