
Wan 3.0 Pro is the high-resolution tier of Alibaba's Wan 3.0 line. It keeps the multimodal inputs and 2–30 second range, and outputs at 1080p, 2K or 4K for finishing rather than drafting.
Wan 3.0 Pro
AlibabaVideo
ReleasedAugust 2026
Alibaba
PublishedVideoUse model wan-3-0 with a single create call, then poll the result endpoint. All requests use the same API key and USD balance.
Runs end-to-end: submit a task, then poll until it completes.
#!/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
donewan-3-0Wan 3.0 is Alibaba's multimodal video model. It generates clips from 2 to 30 seconds at 480p, 720p or 1080p, starting from text, frames, up to ten reference images, reference videos or reference audio, with a soundtrack generated alongside the picture.
/api/v1/jobs/createTaskCreate a generation task and return its task ID.
/api/v1/jobs/recordInfo?taskId=...Read one task by taskId; poll it until the status is success or fail.
/api/v1/accountReturn the current USD balance of the API key owner.
12 fields
| Parameter | Required | Type | Allowed | Default | Description |
|---|---|---|---|---|---|
| prompt | No | string | ≤ 20000 chars | Not recorded | Shot description; may be empty when reference media fully defines the request. |
| imageUrl | No | string | Not recorded | Not recorded | Keyframe image URLs. The first two entries are the first and last frames. |
| uploadedUrls | No | string[] | ≤ 10 | Not recorded | Up to 10 reference images; cannot be combined with keyframes. |
| imageUrls | No | string[] | ≤ 10 | Not recorded | Additional public image URLs, merged with uploadedUrls and de-duplicated in request order. |
| videoUrls | No | string[] | ≤ 5 | Not recorded | Up to 5 reference videos guiding motion and look. |
| audioUrls | No | string[] | ≤ 5 | Not recorded | Up to 5 reference audio clips guiding the soundtrack. |
| duration | No | number | 2–30 s | 5 s | Video duration in seconds. |
| ratio | No | enum | 16:9, 9:16, 1:1, 4:3, 3:4, adaptive | 16:9 | Output aspect ratio. |
| outputResolution | No | enum | 720p, 1080p, 480p | 720p | Output resolution. |
| generate_audio | No | boolean | true, false | Not recorded | Whether to generate audio with the video. |
| callBackUrl | No | string | Not recorded | Not recorded | HTTPS callback URL for signed completion delivery. Top-level request field, not part of inputs. |
| expectedRevision | No | number | Not recorded | Not recorded | Revision of the model settings the client expects. A mismatch returns HTTP 409 conflict. Top-level request field. |
{
"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"
}| Status values | Description |
|---|---|
| waiting | Task queued |
| generating | Processing in progress |
| success | Output ready |
| fail | Generation failed |
| Code | HTTP | Description |
|---|---|---|
| invalid_params | 400 | Request body, inputs or model ID is invalid. |
| unauthorized | 401 | API key is missing, invalid or expired. |
| insufficient_credits | 402 | Available USD balance is below the quoted amount. The response may include required and available. |
| access_denied | 403 | The task belongs to another account, or the account or entitlement is unavailable. |
| not_found | 404 | Task not found. |
| conflict | 409 | expectedRevision does not match, or the idempotency key was reused with a different payload. |
| concurrency_limit | 429 | The account reached its concurrent task limit. |
| rate_limit | 429 | The account reached its per-minute submission limit. |
| internal_error | 500 | Unexpected server error. |
| service_unavailable | 503 | Authentication or an upstream dependency is temporarily unavailable. |
Send your API key as a Bearer token in the Authorization header. Create and revoke keys in Settings → API keys.
Send Authorization: Bearer API_KEY and Content-Type: application/json. Reuse one Idempotency-Key for the same logical create; the same key with a different payload is rejected.
Authorization: Bearer $I2V_API_KEYContent-Type: application/jsonIdempotency-Key: <uuid>