alibaba/wan/2.1/image-to-video
Wan 2.1 by Alibaba - animate still images into dynamic videos with AI. Transform photos into cinematic clips with natural motion, camera movement, and optional audio generation.
PNG, JPEG, WebP, or GIF · 20 MiB maximum
Example output — click Run to generate your own
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
https://api.sandbase.ai/v1/runalibaba/wan/2.1/image-to-videoInput Schema
6 parameters · 2 required · 4 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
image | string | Required | URL of the input image. If the input image does not match the chosen aspect ratio, it is resized and center cropped. |
prompt | string | Required | The text prompt to guide video generation. |
seed | integer | Optional | Random seed for reproducibility. If None, a random seed is chosen. |
resolution | string | Optional | Resolution of the generated video (480p or 720p). 480p is 0.5 billing units, and 720p is 1 billing unit. · Options: 480p, 720p · Default: "720p" 480p720p |
guide_scale | number | Optional | Classifier-free guidance scale. Higher values give better adherence to the prompt but may decrease quality. · Min: 1 · Max: 10 · Default: 5 |
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 |
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
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/2.1/image-to-video",
"image": "https://static.sandbase.ai/examples/alibaba/wan/2.1/image-to-video/input_image_0.png",
"prompt": "Cars racing in slow motion",
"resolution": "720p",
"guide_scale": 5
}'
# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
-H "Authorization: Bearer YOUR_API_KEY"API README
Wan 2.1 Image to Video
Wan 2.1 Image to Video creates a generated clip from one opening image and a motion prompt. The still supplies the scene and subject appearance, while the text explains what should happen after that first frame. It is a straightforward image-animation workflow within the Wan 2.1 family.
The route targets compact 480p or 720p outputs where the task is establishing movement from an existing visual. Guidance strength can tune how tightly generation follows the written direction. The result is delivered as a new video asset.
Highlights
- High visual quality from images. The exact route is presented as generating high-quality video from an image. The supplied frame anchors the sequence.
- Motion diversity. Wan 2.1 explicitly emphasizes varied motion in image-to-video results. A starting still can support different action concepts.
- Dedicated image-to-video evaluation result. In a dedicated image-to-video human evaluation, Wan2.1 led every compared model. This statement is limited to that published comparison.
- Natural-looking motion from a single still. Wan 2.1 produces fluid, natural-looking video and realistic motion from one input image, supporting scenes that should feel animated rather than simply displaced.
Pricing
| Billing unit | Price |
|---|---|
| Base price per request | $0.20 |
When to Use
| ✅ Good fit | ❌ Consider alternatives |
|---|---|
| Turning one established image into a moving scene | Starting without an image |
| Exploring movements from the same frame | Editing an existing video |
| Producing compact 480p or 720p concepts | Requiring 1080p or 4K |
| Tuning adherence to a motion brief | Requiring a fixed frame sequence |
| Creating a clip for rapid visual review | Adding a soundtrack through this schema |
Prompt Guide
Describe the motion and camera behavior that should emerge from the supplied frame.
Subject action: [movement]
Camera: [shot and motion]
Environment: [moving elements]
Pacing: [tempo]
Ending: [final framing]
{
"image": "https://example.com/opening-image.png",
"prompt": "The cars race forward in slow motion as the camera pans beside them and settles into a wide view.",
"resolution": "720p",
"guide_scale": 5,
"aspect_ratio": "16:9",
"seed": 42
}
Technical Specs
| Spec | Value |
|---|---|
| Model ID | alibaba/wan/2.1/image-to-video |
| Required inputs | image and prompt |
| Resolution | 480p or 720p; default 720p |
| Guidance scale | 1 to 10; default 5 |
| Aspect ratio | 10 presets from 21:9 through 9:16 |
| Repeatability | Optional integer seed |
| Output | Video URL and content type |
| Execution | Asynchronous job |
Related
- Wan 2.1 First/Last Frame to Video — use two boundary frames when both ends are defined.
