Wan 3.0 Prime API
Wan 3.0 Prime:由文字、图片、视频或音频生成视频。
- 720p 输出
- 2 到 30 秒的片段
- 带参考视频时,输入视频最长 15 秒

价格
价格自 2026-11-09 起生效
| 档位 | 价格 |
|---|---|
720p | 28 积分/秒 ($0.14/秒)注 12–30 秒 |
720p(含视频输入) 720p-video | 28 积分/秒 ($0.14/秒)注 2, 32–30 秒 |
- 最多冻结 30 秒,按实际时长扣费。
- 费率同时适用于输入和输出的秒数。
- 最多冻结 30 秒输出加 15 秒输入,按实际时长扣费。
1 积分 ≈ $0.005。按标准充值包计算;较大的充值包含赠送积分,实际单价更低。
交付与计费
- 成品
- 成品文件列在任务结果中,每个文件有素材 ID 和类型。
- 下载
- 文件保存 7 天,通过短期签名链接下载,可随时删除。
- 计费
- 任务受理时冻结积分,交付后扣费。生成失败,或 24 小时内未交付,冻结的积分会全部释放。
- 通知
- 按任务 ID 轮询,或使用签名 Webhook,并按 event_id 去重。
如何计费?
生成失败会扣费吗?
API 参考
任务只创建一次,之后按 ID 查询。 完整脚本(含上传和下载) · API 文档
API=https://api.vizoapi.com/v1
AUTH="Authorization: Bearer $VIZO_API_KEY"
# Create the task once and keep its ID.
ID=$(curl -fsS $API/generations -H "$AUTH" -H "Content-Type: application/json" \
-d '{
"model": "wan-3-0-prime",
"input": {
"prompt": "雨夜霓虹街道的缓慢推镜",
"parameters": {
"ratio": "16:9",
"duration": 5
}
},
"metadata": {
"client_reference": "my-unique-reference-1"
}
}' | jq -r .id)
# Poll until the task closes, then read its status and result.
until curl -fsS $API/generations/$ID -H "$AUTH" | jq -e '.closed_at != null' > /dev/null; do sleep 5; done
curl -fsS $API/generations/$ID -H "$AUTH" | jq '{status, result}'全部字段
在 input 中发送这些字段。表中没有的字段会被拒绝,返回 HTTP 422 invalid_input。
- Send a
prompt,mediaor both. first_frameandlast_frame(at most one each) cannot be combined with reference items,fileorlink.- Reference videos total at most 15 seconds, reference audios at most 15 seconds, and reference video input plus output length at most 30 seconds.
| 字段 | 说明 |
|---|---|
| 必填: Up to 20000 characters. Cite media in order, for example image 1 or video 1. Send a prompt, media or both. 最多 20,000 个字符 |
| 必填: first_frame and last_frame (at most 1 each) cannot be combined with reference items, file or link. Up to 10 reference images, 5 reference videos (15 seconds in total) and 5 reference audios; at most one file or one link, not both. 至少 1 项 · 最多 22 项 |
media[]. | Media kind. 可选值 first_framelast_framereference_imagereference_videoreference_audiofilelink |
media[]. | An https URL or an uploaded asset id (ast_...). file and link take a public https URL only. 最多 4000 个字符 · 格式 |
| |
parameters. | Output resolution. Only 720P. 固定值 默认值 |
parameters. | Output aspect ratio. Defaults to adaptive. 可选值 adaptive16:94:31:13:49:16默认值 |
parameters. | Output seconds, 2 to 30, or -1 for automatic length. Holds the maximum; known input reduces it to fit the 30-second total. 2 到 30,或 |
parameters. | Adds a soundtrack. Defaults to true. 默认值 |
parameters. | Random seed. 最小 0 · 最大 2,147,483,647 |
parameters. | Add a visible watermark. Defaults to false; the tier price is unchanged. 默认值 |
完整请求与响应示例
完整的创建请求、202 响应,以及任务成功后的状态。 此输入选择 720p 档位,每秒 28 积分。5 秒共冻结 140.000 积分。
请求
{
"model": "wan-3-0-prime",
"input": {
"prompt": "A paper boat drifting on a pond at dawn, slow dolly in",
"parameters": {
"ratio": "16:9",
"duration": 5
}
},
"metadata": {
"client_reference": "my-unique-reference-1"
}
}202 已受理
{
"id": "gen_01JD8Z5QW3XR",
"model": "wan-3-0-prime",
"source": "api",
"created_at": "2026-11-08T09:00:00Z",
"customer_resolution_deadline": "2026-11-09T09:00:00Z",
"late_result_available": false,
"metadata": {
"client_reference": "my-unique-reference-1"
},
"status": "processing",
"execution_status": "processing",
"delivery_status": "pending",
"billing_status": "pending",
"version": 1,
"price": {
"unit": "credit",
"estimated": "140.000",
"reserved": "0.000",
"charged": "0.000",
"refunded": "0.000"
},
"allowed_actions": [],
"closed_at": null,
"error": null,
"result": null
}200 已成功
{
"id": "gen_01JD8Z5QW3XR",
"model": "wan-3-0-prime",
"source": "api",
"created_at": "2026-11-08T09:00:00Z",
"customer_resolution_deadline": "2026-11-09T09:00:00Z",
"late_result_available": false,
"metadata": {
"client_reference": "my-unique-reference-1"
},
"status": "succeeded",
"execution_status": "succeeded",
"delivery_status": "ready",
"billing_status": "settled",
"version": 4,
"price": {
"unit": "credit",
"estimated": "140.000",
"reserved": "0.000",
"charged": "140.000",
"refunded": "0.000"
},
"allowed_actions": [],
"closed_at": "2026-11-08T09:01:31Z",
"error": null,
"result": {
"asset_id": "ast_01JD8Z9M2C4V",
"outputs": [
{
"index": 0,
"asset_id": "ast_01JD8Z9M2C4V",
"content_type": "video/mp4"
}
]
}
}

