Model CenterMaiopc
wan3.0-prime-r2v-c1
Model information
| Field | Value |
|---|---|
Model ID (model) | wan3.0-prime-r2v-c1 |
| 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 KeyAll 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.promptstringrequiredPrompt
Text prompt input.
Minimum:1
reference_imagesimage[]Reference images
参考图片输入。
Range:0 – 10
Items:0 - 10
Provide a publicly accessible resource URL.
reference_videosvideo[]Reference videos
Reference video inputs.
Range:0 – 5
Items:0 - 5
Provide a publicly accessible resource URL.
reference_audiosaudio[]Reference audios
Reference audio inputs.
Range:0 – 5
Items:0 - 5
Provide a publicly accessible resource URL.
durationintegerDuration
Generated video duration.
aspect_ratiostringAspect ratio
输出画幅比例。如16:9或9:16
resolutionstringResolution
Output resolution tier.
Allowed values:
720p, 1080psizestringSize
Output size or pixel format.
seedintegerSeed
Deterministic generation seed.
first_imageimage[]First frame
First-frame image input.
Range:0 – 1
Items:0 - 1
Provide a publicly accessible resource URL.
last_imageimage[]Last frame
Last-frame image constraint.
Range:0 – 1
Items:0 - 1
Provide a publicly accessible resource URL.
generate_audiobooleanGenerate audio
Whether to generate an audio track.
Default:
falseResponse 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. |
task_id | 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>
idstringrequiredThe 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.
