Wan 3.0 Prime
使用此模型提交视频生成任务,再通过返回的任务 ID 查询结果。
模型 ID wan-3-0-pro
快速开始
创建 并设置 I2V_API_KEY。每个新任务设置一个 IDEMPOTENCY_KEY,重试同一次提交时复用原幂等键和请求体。
提交任务
POST https://api.i2v.ai/api/v1/jobs/createTask
bash
curl "https://api.i2v.ai/api/v1/jobs/createTask" \
-H "Authorization: Bearer $I2V_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "wan-3-0-pro",
"inputs": {
"prompt": "A calm lake at sunrise",
"duration": 5,
"resolution": "1080p",
"aspectRatio": "16:9"
}
}'HTTP 200 表示任务已受理。保存返回的 taskId。
json
{"taskId":"YOUR_TASK_ID"}查询结果
bash
curl "https://api.i2v.ai/api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID" \
-H "Authorization: Bearer $I2V_API_KEY"将 YOUR_TASK_ID 替换为返回的任务 ID。状态为 waiting 或 generating 时退避轮询。success 时读取 output[].url,fail 时检查 error。
请求参数
模型输入放在 inputs 对象中。素材 URL 需要可公开访问。必需素材及参数组合取决于具体生成模式。
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
inputs.prompt | string | 否 | — | 镜头描述;参考素材已完整定义请求时可为空。 上限 20000 字符. |
inputs.resolution | string | 否 | 1080p | 输出分辨率。 可选值 480p, 720p, 1080p. |
inputs.aspectRatio | string | 否 | 16:9 | 输出宽高比。 可选值 16:9, 9:16, 1:1, 4:3, 3:4, adaptive. |
inputs.duration | number | 否 | 5 | 视频时长,单位为秒。 可选值 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, , , , , , , , , , , , , , , . |

