
Wan 3.0 Pro 是阿里 Wan 3.0 系列的高分辨率档位。保留多模态输入与 2–30 秒时长,输出 1080p / 2K / 4K,适合成片而不是草稿。
Wan 3.0 Pro
Alibaba视频
发布时间2026年8月
wan-3-0Wan 3.0 是阿里的多模态视频模型。支持 2–30 秒、480p / 720p / 1080p,可从文本、首尾帧、最多 10 张参考图、参考视频或参考音频出发,并默认随画面生成声音。
使用模型 wan-3-0 发起一次创建请求,再轮询结果接口。所有请求共用同一个 API Key 与美元余额余额。
可直接运行:提交任务后轮询,直到任务完成。
#!/usr/bin/env bash
set -euo pipefail
I2V_API_KEY="${I2V_API_KEY:?Set your API key: export I2V_API_KEY=...}"
# 1. Submit task
RESPONSE=$(curl -s -X POST "https://i2v.ai/api/v1/jobs/createTask" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $I2V_API_KEY" \
-d '{
"model": "wan-3-0",
"inputs": {
"prompt": "A calm lake at sunrise",
"duration": 5,
"resolution": "720p",
"aspectRatio": "16:9"
}
}')
TASK_ID=$(echo "$RESPONSE" | grep -o '"taskId":"[^"]*"' | cut -d'"' -f4)
echo "Task created: $TASK_ID"
# 2. Poll until complete
while true; do
RESULT=$(curl -s "https://i2v.ai/api/v1/jobs/recordInfo?taskId=...?taskId=$TASK_ID" \
-H "Authorization: Bearer $I2V_API_KEY")
STATUS=$(echo "$RESULT" | grep -o '"status":"[^"]*"' | head -1 | cut -d'"' -f4)
case "$STATUS" in
success) echo "$RESULT"; break ;;
fail) echo "Failed: $RESULT"; exit 1 ;;
*) echo "Status: $STATUS — waiting..."; sleep 2 ;;
esac
done/api/v1/jobs/createTask创建生成任务并返回 taskId。
/api/v1/jobs/recordInfo?taskId=...按 taskId 查询单个任务,轮询到 success 或 fail。
/api/v1/account返回 API Key 所属账号的当前美元余额余额。
12 个字段
| 参数 | 必填 | 类型 | 取值 | 默认值 | 说明 |
|---|---|---|---|---|---|
| prompt | 否 | string | ≤ 20000 chars | 未记录 | 镜头描述;参考素材已完整定义请求时可为空。 |
| imageUrl | 否 | string | 未记录 | 未记录 | 关键帧图片地址,前两项分别为首帧和尾帧。 |
| uploadedUrls | 否 | string[] | ≤ 10 | 未记录 | 最多 10 张参考图;不能与首尾帧同时使用。 |
| imageUrls | 否 | string[] | ≤ 10 | 未记录 | 额外的公开图片 URL,与 uploadedUrls 合并并按请求顺序去重。 |
| videoUrls | 否 | string[] | ≤ 5 | 未记录 | 最多 5 段参考视频,用于引导运动与质感。 |
| audioUrls | 否 | string[] | ≤ 5 | 未记录 | 最多 5 段参考音频,用于引导声音。 |
| duration | 否 | number | 2–30 s | 5 s | 视频时长,单位为秒。 |
| ratio | 否 | enum | 16:9, 9:16, 1:1, 4:3, 3:4, adaptive | 16:9 | 输出宽高比。 |
| outputResolution | 否 | enum | 720p, 1080p, 480p | 720p | 输出分辨率。 |
| generate_audio | 否 | boolean | true, false | 未记录 | 是否同时生成视频声音。 |
| callBackUrl | 否 | string | 未记录 | 未记录 | 完成回调的 HTTPS 地址;属于请求体顶层字段,不放在 inputs 内。 |
| expectedRevision | 否 | number | 未记录 | 未记录 | 客户端期望的模型配置版本号;不一致返回 HTTP 409 conflict;属于请求体顶层字段。 |
{
"taskId": "..."
}{
"taskId": "...",
"model": "wan-3-0",
"status": "success",
"creditsUsed": 100,
"output": [
{
"url": "...",
"width": 1280,
"height": 720
}
],
"error": null,
"createTime": 1760000000000,
"completeTime": 1760000060000
}{
"code": "invalid_params",
"message": "Invalid request parameters"
}| 状态值 | 说明 |
|---|---|
| waiting | 任务排队中 |
| generating | 生成处理中 |
| success | 结果已就绪 |
| fail | 生成失败 |
| 错误码 | HTTP | 说明 |
|---|---|---|
| invalid_params | 400 | 请求体、inputs 或模型 ID 不合法。 |
| unauthorized | 401 | API Key 缺失、无效或已过期。 |
在 Authorization 请求头中以 Bearer Token 传入 API Key。可在「设置 → API 密钥」中创建和吊销。
请求头需包含 Authorization: Bearer API_KEY 与 Content-Type: application/json;同一逻辑创建复用同一个 Idempotency-Key,相同键但请求体不同会被拒绝。
Authorization: Bearer $I2V_API_KEYContent-Type: application/jsonIdempotency-Key: <uuid>| insufficient_credits | 402 | 可用美元余额不足;响应可能附带 required 与 available。 |
| access_denied | 403 | 任务属于其他账号,或账号/权益不可用。 |
| not_found | 404 | 任务不存在。 |
| conflict | 409 | expectedRevision 与服务端不一致,或幂等键被用于不同请求体。 |
| concurrency_limit | 429 | 账号并发任务数达到上限。 |
| rate_limit | 429 | 账号每分钟提交次数达到上限。 |
| internal_error | 500 | 未预期的服务端错误。 |
| service_unavailable | 503 | 鉴权或上游依赖服务暂不可用。 |