alibaba/wan/3.0/reference-to-video
Wan 3.0 by Alibaba - animate still images into dynamic videos with AI. Transform photos into cinematic clips with natural motion, camera movement, and optional audio generation.
Input
Text prompt directing how the reference media is used. Reference media can be addressed positionally, e.g. 'the subject in Image 1 walks past Video 1'.
The aspect ratio of the generated image. Allowed values: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16.
Include generated audio.
Output video resolution tier. Allowed values: 480p, 720p, 1080p.
230
Output duration in seconds. Set to null for smart duration, which lets the model pick a length from the prompt and reference media. Range: 2 to 30.
02147483647
Range: 0 to 2147483647.
Public webpage URL to base the video on. Requires enable_thinking=true. Only pages that do not require login can be read.
Up to 5 reference video URLs totaling at most 15 seconds. Each clip must be at least 16 fps.
Enable enhanced reasoning before generation.
Up to 10 reference image URLs.
Document URL to base the video on. Requires enable_thinking=true.
Up to 5 reference audio URLs totaling at most 15 seconds.
Idle
Example output — click Run to generate your own
Production endpoint
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
POST
https://api.sandbase.ai/v1/runModel ID
alibaba/wan/3.0/reference-to-video01
Input Schema
12 parameters · 1 required · 11 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
prompt | string | Required | Text prompt directing how the reference media is used. Reference media can be addressed positionally, e.g. 'the subject in Image 1 walks past Video 1'. · Max length: 5000 |
seed | integer | Optional | Min: 0 · Max: 2147483647 |
audio | boolean | Optional | Include generated audio. · Default: true |
web_url | string | Optional | Public webpage URL to base the video on. Requires enable_thinking=true. Only pages that do not require login can be read. |
duration | integer | Optional | Output duration in seconds. Set to null for smart duration, which lets the model pick a length from the prompt and reference media. · Min: 2 · Max: 30 · Default: 5 |
file_url | string | Optional | Document URL to base the video on. Requires enable_thinking=true. |
resolution | string | Optional | Output video resolution tier. · Options: 480p, 720p, 1080p · Default: "1080p" 480p720p1080p |
aspect_ratio | string | Optional | The aspect ratio of the generated image. · Options: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16 21:916:93:24:35:41:14:53:42:39:16 |
enable_thinking | boolean | Optional | Enable enhanced reasoning before generation. · Default: false |
reference_audio_urls | string[] | Optional | Up to 5 reference audio URLs totaling at most 15 seconds. |
reference_image_urls | string[] | Optional | Up to 10 reference image URLs. |
reference_video_urls | string[] | Optional | Up to 5 reference video URLs totaling at most 15 seconds. Each clip must be at least 16 fps. |
02
Output Schema
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the generation task |
status | string | Task status: pending, running, completed, failed, timeout |
model | string | Model used for the generation |
outputs | array | Array of output items |
outputs[].url | string | URL of the generated artifact |
outputs[].content_type | string | MIME type (e.g. image/png, video/mp4) |
error | object | null | Error details if failed, null on success |
error.type | string | Machine-readable error type code |
error.message | string | Human-readable error description |
Async Workflow
This model uses asynchronous execution. Submit a request and poll for the result.
- Submit — POST to /v1/run, receive an
id - Poll — GET /v1/run/{id} until status is
completed,failed, ortimeout - Retrieve — Read
outputsfrom the completed response
03
Code Examples
Ready-to-run snippets
# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "alibaba/wan/3.0/reference-to-video",
"audio": true,
"duration": 5,
"resolution": "1080p",
"enable_thinking": false,
"prompt": "a beautiful sunset over mountains"
}'
# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
-H "Authorization: Bearer YOUR_API_KEY"API README
PRICED DRAFT — MANUAL REVIEW REQUIRED
Pricing is calculated by output duration and resolution: $0.05/second at 480p, $0.10/second at 720p, and $0.20/second at 1080p. The default is billed at 5 seconds and 1080p, for a default price of $1.00. Missing duration or resolution defaults to 5 seconds or 1080p, respectively; unknown resolutions use the highest 1080p tier. Audio, aspect ratio, and prompt expansion do not affect the price.
checked_at: 2026-08-31