Wan 2.6 & 2.5 — AI Video & Image Generation by Alibaba
Generate AI videos and images using Alibaba's Wan 2.6 and Wan 2.5 — featuring text-to-video, image-to-video, video-to-video, text-to-image, and image editing with up to 1080p resolution, 15-second duration, multi/single camera modes, audio-guided generation, and built-in prompt expansion.
Wan 2.6 is the latest flagship model with cinematic motion quality, multi-camera shot types, audio URL input for guided generation, and video-to-video transfer with character-level prompt control. Wan 2.5 offers a cost-effective alternative with 480p support and Flash variants for rapid prototyping.
Data usage note: This skill sends text prompts, image URLs, audio URLs, and video files to the Atlas Cloud API (api.atlascloud.ai) for generation. No data is stored locally beyond the downloaded output files. API usage incurs charges based on resolution, duration, and model selected.
Key Capabilities
- Text-to-Video — Generate video clips from text descriptions with optional audio (2.6 / 2.5)
- Image-to-Video — Animate still images into dynamic video (2.6 / 2.5)
- Video-to-Video — Transfer style or replace characters in existing videos using
characterX prompt notation (2.6)
- Text-to-Image — Generate images from text descriptions, 27 preset sizes (2.6)
- Image Editing — Edit images with prompt-based instructions, up to 4 reference images (2.6)
- Audio-Guided Generation — Provide an audio URL to guide video generation with synchronized sound (2.6)
- Multi/Single Camera —
multi_camera for dynamic shots, single_camera for stable framing (2.6)
- Prompt Expansion — Built-in prompt optimization for better results
- Up to 1080p — Resolutions: 480p, 720p, 1080p
- Up to 15s — Duration: 5/10/15 seconds (2.6), 5/10 seconds (2.5)
- Flash Variants — Fast, budget-friendly generation for drafts (2.6 I2V Flash, 2.5 Fast)
Setup
- Sign up at https://www.atlascloud.ai
- Console → API Keys → Create new key
- Set env:
export ATLASCLOUD_API_KEY="your-key"
The API key is tied to your Atlas Cloud account and its pay-as-you-go balance. All usage is billed to this account. Atlas Cloud does not currently support scoped keys — the key grants access to all models available on your account.
Pricing
Wan 2.6 — Video Models (per second, by resolution)
All video prices are per second of video generated. Atlas Cloud pricing varies by resolution.
Text-to-Video & Video-to-Video
| Resolution |
fal.ai |
Atlas Cloud |
Savings |
| 480p |
- |
$0.04/s |
- |
| 720p |
$0.10/s |
$0.08/s |
20% off |
| 1080p |
$0.15/s |
$0.12/s |
20% off |
Image-to-Video
| Resolution |
fal.ai |
Atlas Cloud |
Savings |
| 720p |
$0.10/s |
$0.10/s |
- |
| 1080p |
$0.15/s |
$0.15/s |
- |
Image-to-Video Flash
| Resolution |
Atlas Cloud |
| All |
$0.018/s |
Wan 2.6 — Image Models (per image)
| Model |
Original |
Atlas Cloud |
Savings |
| Text-to-Image |
$0.03 |
$0.021 |
30% off |
| Image Edit |
$0.035 |
$0.021 |
40% off |
Wan 2.5 — Video Models (per second, flat rate)
| Model |
Atlas Cloud |
Duration |
| Text-to-Video |
$0.035/s |
5/10 seconds |
| Image-to-Video |
$0.035/s |
5/10 seconds |
fal.ai pricing sourced from fal.ai/models/wan.
Available Models
Wan 2.6 Video
| Model ID |
Type |
Resolution |
Duration |
alibaba/wan-2.6/text-to-video |
Text-to-Video |
480p–1080p |
5/10/15s |
alibaba/wan-2.6/image-to-video |
Image-to-Video |
720p–1080p |
5/10/15s |
alibaba/wan-2.6/image-to-video-flash |
Image-to-Video (Fast) |
720p–1080p |
5/10/15s |
alibaba/wan-2.6/video-to-video |
Video-to-Video |
480p–1080p |
5/10s |
Wan 2.6 Image
| Model ID |
Type |
Max Size |
alibaba/wan-2.6/text-to-image |
Text-to-Image |
2184×936 |
alibaba/wan-2.6/image-edit |
Image Editing |
24 presets |
Wan 2.5 Video
| Model ID |
Type |
Resolution |
Duration |
alibaba/wan-2.5/text-to-video |
Text-to-Video |
480p–1080p |
5/10s |
alibaba/wan-2.5/image-to-video |
Image-to-Video |
480p–1080p |
5/10s |
Parameters
Wan 2.6 — Text-to-Video
| Parameter |
Type |
Required |
Default |
Description |
prompt |
string |
Yes |
- |
Video description |
negative_prompt |
string |
No |
- |
What to exclude from the video |
size |
string |
No |
1280*720 |
Output size (see Size Options below) |
duration |
integer |
No |
5 |
5, 10, or 15 seconds |
shot_type |
string |
No |
- |
multi_camera for dynamic shots, single_camera for stable framing |
audio |
string |
No |
- |
Audio URL to guide generation with synchronized sound |
generate_audio |
boolean |
No |
false |
Generate synchronized audio |
enable_prompt_expansion |
boolean |
No |
false |
Expand prompt for better results |
seed |
integer |
No |
random |
For reproducible results |
Wan 2.6 — Image-to-Video
Same as text-to-video (without size), plus:
| Parameter |
Type |
Required |
Default |
Description |
image |
string |
Yes |
- |
Source image URL |
resolution |
string |
No |
720p |
720p, 1080p |
Wan 2.6 — Video-to-Video
| Parameter |
Type |
Required |
Default |
Description |
prompt |
string |
Yes |
- |
Video description (use character1, character2 to reference characters in video) |
negative_prompt |
string |
No |
- |
What to exclude |
videos |
array |
Yes |
- |
Source video URLs (max 100MB each, 2-30s duration) |
size |
string |
No |
1280*720 |
Output size |
duration |
integer |
No |
5 |
5 or 10 seconds |
shot_type |
string |
No |
- |
multi_camera or single_camera |
enable_prompt_expansion |
boolean |
No |
false |
Expand prompt for better results |
seed |
integer |
No |
random |
For reproducible results |
Wan 2.6 — Text-to-Image
| Parameter |
Type |
Required |
Default |
Description |
prompt |
string |
Yes |
- |
Image description |
negative_prompt |
string |
No |
- |
What to exclude |
size |
string |
No |
1024*1024 |
Output size (27 presets, see below) |
enable_prompt_expansion |
boolean |
No |
false |
Expand prompt |
enable_sync_mode |
boolean |
No |
false |
Wait for result synchronously |
enable_base64_output |
boolean |
No |
false |
Return Base64 instead of URL |
seed |
integer |
No |
random |
For reproducible results |
Wan 2.6 — Image Edit
Same as text-to-image, plus:
| Parameter |
Type |
Required |
Default |
Description |
images |
array |
Yes |
- |
Images to edit (max 4, 384-5000px per side) |
Wan 2.5 — Text-to-Video
| Parameter |
Type |
Required |
Default |
Description |
prompt |
string |
Yes |
- |
Video description |
negative_prompt |
string |
No |
- |
What to exclude |
size |
string |
No |
1280*720 |
Output size (13 presets, including 480p) |
duration |
integer |
No |
5 |
5 or 10 seconds |
audio |
string |
No |
- |
Audio URL for guided generation |
generate_audio |
boolean |
No |
false |
Generate synchronized audio |
enable_prompt_expansion |
boolean |
No |
false |
Expand prompt |
seed |
integer |
No |
random |
For reproducible results |
Wan 2.5 — Image-to-Video
Same as Wan 2.5 text-to-video (without size), plus:
| Parameter |
Type |
Required |
Default |
Description |
image |
string |
Yes |
- |
Source image URL |
resolution |
string |
No |
720p |
480p, 720p, 1080p |
Video Size Options (Wan 2.6)
T2V / V2V (10 presets):
1280*720, 720*1280, 960*960, 1920*1080, 1080*1920, 1280*960, 960*1280, 1920*816, 816*1920, 1280*544
Image Size Options (Wan 2.6 — 27 presets):
1024*1024, 1280*720, 720*1280, 1280*960, 960*1280, 1536*1024, 1024*1536, 1280*1280, 1536*1536, 2048*1024, 1024*2048, 1536*1280, 1280*1536, 1680*720, 720*1680, 2016*864, 864*2016, 1536*864, 864*1536, 2184*936, 936*2184, 1400*1050, 1050*1400, 1680*1050, 1050*1680, 1176*1176, 1560*1560
Workflow: Submit → Poll → Download
Text-to-Video Example (Wan 2.6)
# Step 1: Submit
curl -s -X POST "https://api.atlascloud.ai/api/v1/model/generateVideo" \
-H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "alibaba/wan-2.6/text-to-video",
"prompt": "A drone shot flying over ancient ruins at golden hour, camera slowly descending toward a central courtyard",
"size": "1920*1080",
"duration": 10,
"shot_type": "multi_camera",
"generate_audio": true,
"enable_prompt_expansion": true
}'
# Returns: { "code": 200, "data": { "id": "prediction-id" } }
# Step 2: Poll (every 5 seconds until completed)
curl -s "https://api.atlascloud.ai/api/v1/model/result/{prediction-id}" \
-H "Authorization: Bearer $ATLASCLOUD_API_KEY"
# Returns: { "code": 200, "data": { "status": "completed", "outputs": ["https://...video-url..."] } }
# Step 3: Download
curl -o output.mp4 "VIDEO_URL_FROM_OUTPUTS"
Image-to-Video Example (Wan 2.6)
curl -s -X POST "https://api.atlascloud.ai/api/v1/model/generateVideo" \
-H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "alibaba/wan-2.6/image-to-video",
"image": "https://example.com/landscape.jpg",
"prompt": "The camera slowly zooms in as clouds drift across the sky and leaves rustle in the wind",
"resolution": "1080p",
"duration": 5,
"generate_audio": true
}'
Video-to-Video Example (Wan 2.6)
curl -s -X POST "https://api.atlascloud.ai/api/v1/model/generateVideo" \
-H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "alibaba/wan-2.6/video-to-video",
"videos": ["https://example.com/original-video.mp4"],
"prompt": "Transform character1 into a cartoon anime character, keep the background unchanged",
"size": "1280*720",
"duration": 5,
"shot_type": "single_camera"
}'
Audio-Guided Generation Example (Wan 2.6)
curl -s -X POST "https://api.atlascloud.ai/api/v1/model/generateVideo" \
-H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "alibaba/wan-2.6/text-to-video",
"prompt": "A jazz band performing on stage, musicians playing saxophone and piano",
"audio": "https://example.com/jazz-music.mp3",
"size": "1920*1080",
"duration": 10
}'
Text-to-Image Example (Wan 2.6)
curl -s -X POST "https://api.atlascloud.ai/api/v1/model/generateImage" \
-H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "alibaba/wan-2.6/text-to-image",
"prompt": "A cyberpunk cityscape at night, neon signs reflected in rain puddles, photorealistic",
"size": "1680*720",
"enable_prompt_expansion": true
}'
# Returns: { "code": 200, "data": { "id": "prediction-id" } }
Image Editing Example (Wan 2.6)
curl -s -X POST "https://api.atlascloud.ai/api/v1/model/generateImage" \
-H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "alibaba/wan-2.6/image-edit",
"prompt": "Change the background to a sunset beach scene, keep the person unchanged",
"images": ["https://example.com/photo.jpg"],
"size": "1280*720"
}'
Image-to-Video Flash Example (Wan 2.6)
curl -s -X POST "https://api.atlascloud.ai/api/v1/model/generateVideo" \
-H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "alibaba/wan-2.6/image-to-video-flash",
"image": "https://example.com/portrait.jpg",
"prompt": "The person slowly turns and smiles",
"resolution": "720p",
"duration": 5
}'
Polling Logic
processing / starting / running → wait 5s, retry (typically takes ~30-120s for video, ~5-10s for image)
completed / succeeded → done, get URL from data.outputs[]
failed → error, read data.error
Atlas Cloud MCP Tools (if available)
If the Atlas Cloud MCP server is configured, use built-in tools:
atlas_generate_video(model="alibaba/wan-2.6/text-to-video", params={...})
atlas_generate_image(model="alibaba/wan-2.6/text-to-image", params={...})
atlas_get_prediction(prediction_id="...")
Implementation Guide
Determine task type:
- Text-to-video: user describes a scene/action in text → 2.6 T2V or 2.5 T2V
- Image-to-video: user provides an image to animate → 2.6 I2V or 2.6 I2V Flash (budget)
- Video-to-video: user wants to transform an existing video → 2.6 V2V
- Text-to-image: user wants to generate an image → 2.6 T2I
- Image editing: user wants to modify existing images → 2.6 Image Edit
Choose model version:
- Wan 2.6 (recommended): Latest generation, best quality, multi-camera, audio-guided, V2V
- Wan 2.6 Flash: Budget I2V at $0.018/s — ideal for drafts
- Wan 2.5: Cost-effective at $0.035/s flat rate, supports 480p
Extract parameters:
- Prompt: describe scene, action, camera movement
- Negative prompt: exclude undesired elements ("blurry, distorted, watermark")
- Resolution: 480p for drafts, 720p default, 1080p for final output
- Duration: 5s default, up to 15s for 2.6, up to 10s for 2.5
- Shot type (2.6 only):
multi_camera for dynamic shots, single_camera for stable framing
- Audio: provide URL for audio-guided generation, or set
generate_audio: true
- Prompt expansion: set
enable_prompt_expansion: true for auto-optimized prompts
Execute: POST to generateVideo/generateImage API → poll result → download
Present result: show file path, offer to play/open
Prompt Tips
- Scene + Action: "A samurai draws his sword in a bamboo forest at dawn, mist rising from the ground"
- Camera direction: "Camera slowly dollies forward...", "Aerial tracking shot of...", "First-person POV walking through..."
- Multi-camera: Use
shot_type: "multi_camera" with prompts like "Cut between close-up and wide shot..."
- V2V character control: Reference characters as
character1, character2 — e.g., "Transform character1 into an anime character"
- Audio-guided: Provide an audio URL to sync video with music, dialogue, or sound effects
- Negative prompts: "blurry, low quality, distorted faces, watermark, text overlay"
Model Comparison
| Feature |
Wan 2.6 |
Wan 2.5 |
| Video T2V Price (720p) |
$0.08/s |
$0.035/s |
| Video I2V Price (720p) |
$0.10/s |
$0.035/s |
| Max Resolution |
1080p |
1080p |
| Max Duration |
15s |
10s |
| Shot Type Control |
Yes |
No |
| Audio-Guided |
Yes |
Yes |
| Video-to-Video |
Yes |
No |
| Text-to-Image |
Yes ($0.021) |
No |
| Image Editing |
Yes ($0.021) |
No |
| Flash/Fast Variants |
I2V Flash ($0.018/s) |
Yes |
| Prompt Expansion |
Yes |
Yes |
1---2name: wan-23description: Generate AI videos and images using Alibaba's Wan 2.6 and Wan 2.5 — featuring text-to-video, image-to-video, video-to-video, text-to-image, and image editing with up to 1080p resolution, 15-second duration, multi/single camera shot types, audio-guided generation, and prompt expansion. Supports 18 model variants across 2 generations. Available via Atlas Cloud API at up to 30% off standard pricing. Use this skill whenever the user wants to generate AI videos, create video clips, animate images, edit videos, generate images, edit photos, or mentions Wan, Alibaba video, Tongyi video, Wanx, or Wan 2.6/2.5. Also trigger when users ask to create product demos, marketing videos, social media reels, animated scenes, cinematic clips, video-to-video transfers, character-consistent video edits, multi-camera shots, or any visual content using AI.4---5
6# Wan 2.6 & 2.5 — AI Video & Image Generation by Alibaba
7
8Generate AI videos and images using Alibaba's Wan 2.6 and Wan 2.5 — featuring text-to-video, image-to-video, video-to-video, text-to-image, and image editing with up to 1080p resolution, 15-second duration, multi/single camera modes, audio-guided generation, and built-in prompt expansion.
9
10Wan 2.6 is the latest flagship model with cinematic motion quality, multi-camera shot types, audio URL input for guided generation, and video-to-video transfer with character-level prompt control. Wan 2.5 offers a cost-effective alternative with 480p support and Flash variants for rapid prototyping.
11
12> **Data usage note**: This skill sends text prompts, image URLs, audio URLs, and video files to the Atlas Cloud API (`api.atlascloud.ai`) for generation. No data is stored locally beyond the downloaded output files. API usage incurs charges based on resolution, duration, and model selected.
13
14---
15
16## Key Capabilities
17
18- **Text-to-Video** — Generate video clips from text descriptions with optional audio (2.6 / 2.5)
19- **Image-to-Video** — Animate still images into dynamic video (2.6 / 2.5)
20- **Video-to-Video** — Transfer style or replace characters in existing videos using `characterX` prompt notation (2.6)
21- **Text-to-Image** — Generate images from text descriptions, 27 preset sizes (2.6)
22- **Image Editing** — Edit images with prompt-based instructions, up to 4 reference images (2.6)
23- **Audio-Guided Generation** — Provide an audio URL to guide video generation with synchronized sound (2.6)
24- **Multi/Single Camera** — `multi_camera` for dynamic shots, `single_camera` for stable framing (2.6)
25- **Prompt Expansion** — Built-in prompt optimization for better results
26- **Up to 1080p** — Resolutions: 480p, 720p, 1080p
27- **Up to 15s** — Duration: 5/10/15 seconds (2.6), 5/10 seconds (2.5)
28- **Flash Variants** — Fast, budget-friendly generation for drafts (2.6 I2V Flash, 2.5 Fast)
29
30---
31
32## Setup
33
341. Sign up at https://www.atlascloud.ai
352. Console → API Keys → Create new key
363. Set env: `export ATLASCLOUD_API_KEY="your-key"`
37
38The API key is tied to your Atlas Cloud account and its pay-as-you-go balance. All usage is billed to this account. Atlas Cloud does not currently support scoped keys — the key grants access to all models available on your account.
39
40---
41
42## Pricing
43
44### Wan 2.6 — Video Models (per second, by resolution)
45
46All video prices are per second of video generated. Atlas Cloud pricing varies by resolution.
47
48#### Text-to-Video & Video-to-Video
49
50| Resolution | fal.ai | Atlas Cloud | Savings |
51|:----------:|:------:|:-----------:|:-------:|
52| **480p** | - | **$0.04/s** | - |
53| **720p** | $0.10/s | **$0.08/s** | 20% off |
54| **1080p** | $0.15/s | **$0.12/s** | 20% off |
55
56#### Image-to-Video
57
58| Resolution | fal.ai | Atlas Cloud | Savings |
59|:----------:|:------:|:-----------:|:-------:|
60| **720p** | $0.10/s | **$0.10/s** | - |
61| **1080p** | $0.15/s | **$0.15/s** | - |
62
63#### Image-to-Video Flash
64
65| Resolution | Atlas Cloud |
66|:----------:|:-----------:|
67| **All** | **$0.018/s** |
68
69### Wan 2.6 — Image Models (per image)
70
71| Model | Original | Atlas Cloud | Savings |
72|-------|:--------:|:-----------:|:-------:|
73| Text-to-Image | ~~$0.03~~ | **$0.021** | 30% off |
74| Image Edit | ~~$0.035~~ | **$0.021** | 40% off |
75
76### Wan 2.5 — Video Models (per second, flat rate)
77
78| Model | Atlas Cloud | Duration |
79|-------|:-----------:|----------|
80| Text-to-Video | **$0.035/s** | 5/10 seconds |
81| Image-to-Video | **$0.035/s** | 5/10 seconds |
82
83> fal.ai pricing sourced from [fal.ai/models/wan](https://fal.ai/models/fal-ai/wan/v2.6/text-to-video).
84
85---
86
87## Available Models
88
89### Wan 2.6 Video
90
91| Model ID | Type | Resolution | Duration |
92|----------|------|:----------:|:--------:|
93| `alibaba/wan-2.6/text-to-video` | Text-to-Video | 480p–1080p | 5/10/15s |
94| `alibaba/wan-2.6/image-to-video` | Image-to-Video | 720p–1080p | 5/10/15s |
95| `alibaba/wan-2.6/image-to-video-flash` | Image-to-Video (Fast) | 720p–1080p | 5/10/15s |
96| `alibaba/wan-2.6/video-to-video` | Video-to-Video | 480p–1080p | 5/10s |
97
98### Wan 2.6 Image
99
100| Model ID | Type | Max Size |
101|----------|------|:--------:|
102| `alibaba/wan-2.6/text-to-image` | Text-to-Image | 2184×936 |
103| `alibaba/wan-2.6/image-edit` | Image Editing | 24 presets |
104
105### Wan 2.5 Video
106
107| Model ID | Type | Resolution | Duration |
108|----------|------|:----------:|:--------:|
109| `alibaba/wan-2.5/text-to-video` | Text-to-Video | 480p–1080p | 5/10s |
110| `alibaba/wan-2.5/image-to-video` | Image-to-Video | 480p–1080p | 5/10s |
111
112---
113
114## Parameters
115
116### Wan 2.6 — Text-to-Video
117
118| Parameter | Type | Required | Default | Description |
119|-----------|------|----------|---------|-------------|
120| `prompt` | string | Yes | - | Video description |
121| `negative_prompt` | string | No | - | What to exclude from the video |
122| `size` | string | No | 1280*720 | Output size (see Size Options below) |
123| `duration` | integer | No | 5 | 5, 10, or 15 seconds |
124| `shot_type` | string | No | - | `multi_camera` for dynamic shots, `single_camera` for stable framing |
125| `audio` | string | No | - | Audio URL to guide generation with synchronized sound |
126| `generate_audio` | boolean | No | false | Generate synchronized audio |
127| `enable_prompt_expansion` | boolean | No | false | Expand prompt for better results |
128| `seed` | integer | No | random | For reproducible results |
129
130### Wan 2.6 — Image-to-Video
131
132Same as text-to-video (without `size`), plus:
133
134| Parameter | Type | Required | Default | Description |
135|-----------|------|----------|---------|-------------|
136| `image` | string | Yes | - | Source image URL |
137| `resolution` | string | No | 720p | 720p, 1080p |
138
139### Wan 2.6 — Video-to-Video
140
141| Parameter | Type | Required | Default | Description |
142|-----------|------|----------|---------|-------------|
143| `prompt` | string | Yes | - | Video description (use `character1`, `character2` to reference characters in video) |
144| `negative_prompt` | string | No | - | What to exclude |
145| `videos` | array | Yes | - | Source video URLs (max 100MB each, 2-30s duration) |
146| `size` | string | No | 1280*720 | Output size |
147| `duration` | integer | No | 5 | 5 or 10 seconds |
148| `shot_type` | string | No | - | `multi_camera` or `single_camera` |
149| `enable_prompt_expansion` | boolean | No | false | Expand prompt for better results |
150| `seed` | integer | No | random | For reproducible results |
151
152### Wan 2.6 — Text-to-Image
153
154| Parameter | Type | Required | Default | Description |
155|-----------|------|----------|---------|-------------|
156| `prompt` | string | Yes | - | Image description |
157| `negative_prompt` | string | No | - | What to exclude |
158| `size` | string | No | 1024*1024 | Output size (27 presets, see below) |
159| `enable_prompt_expansion` | boolean | No | false | Expand prompt |
160| `enable_sync_mode` | boolean | No | false | Wait for result synchronously |
161| `enable_base64_output` | boolean | No | false | Return Base64 instead of URL |
162| `seed` | integer | No | random | For reproducible results |
163
164### Wan 2.6 — Image Edit
165
166Same as text-to-image, plus:
167
168| Parameter | Type | Required | Default | Description |
169|-----------|------|----------|---------|-------------|
170| `images` | array | Yes | - | Images to edit (max 4, 384-5000px per side) |
171
172### Wan 2.5 — Text-to-Video
173
174| Parameter | Type | Required | Default | Description |
175|-----------|------|----------|---------|-------------|
176| `prompt` | string | Yes | - | Video description |
177| `negative_prompt` | string | No | - | What to exclude |
178| `size` | string | No | 1280*720 | Output size (13 presets, including 480p) |
179| `duration` | integer | No | 5 | 5 or 10 seconds |
180| `audio` | string | No | - | Audio URL for guided generation |
181| `generate_audio` | boolean | No | false | Generate synchronized audio |
182| `enable_prompt_expansion` | boolean | No | false | Expand prompt |
183| `seed` | integer | No | random | For reproducible results |
184
185### Wan 2.5 — Image-to-Video
186
187Same as Wan 2.5 text-to-video (without `size`), plus:
188
189| Parameter | Type | Required | Default | Description |
190|-----------|------|----------|---------|-------------|
191| `image` | string | Yes | - | Source image URL |
192| `resolution` | string | No | 720p | 480p, 720p, 1080p |
193
194### Video Size Options (Wan 2.6)
195
196**T2V / V2V (10 presets):**
197`1280*720`, `720*1280`, `960*960`, `1920*1080`, `1080*1920`, `1280*960`, `960*1280`, `1920*816`, `816*1920`, `1280*544`
198
199**Image Size Options (Wan 2.6 — 27 presets):**
200`1024*1024`, `1280*720`, `720*1280`, `1280*960`, `960*1280`, `1536*1024`, `1024*1536`, `1280*1280`, `1536*1536`, `2048*1024`, `1024*2048`, `1536*1280`, `1280*1536`, `1680*720`, `720*1680`, `2016*864`, `864*2016`, `1536*864`, `864*1536`, `2184*936`, `936*2184`, `1400*1050`, `1050*1400`, `1680*1050`, `1050*1680`, `1176*1176`, `1560*1560`
201
202---
203
204## Workflow: Submit → Poll → Download
205
206### Text-to-Video Example (Wan 2.6)
207
208```bash
209# Step 1: Submit
210curl -s -X POST "https://api.atlascloud.ai/api/v1/model/generateVideo" \
211 -H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
212 -H "Content-Type: application/json" \
213 -d '{
214 "model": "alibaba/wan-2.6/text-to-video",
215 "prompt": "A drone shot flying over ancient ruins at golden hour, camera slowly descending toward a central courtyard",
216 "size": "1920*1080",
217 "duration": 10,
218 "shot_type": "multi_camera",
219 "generate_audio": true,
220 "enable_prompt_expansion": true
221 }'
222# Returns: { "code": 200, "data": { "id": "prediction-id" } }
223
224# Step 2: Poll (every 5 seconds until completed)
225curl -s "https://api.atlascloud.ai/api/v1/model/result/{prediction-id}" \
226 -H "Authorization: Bearer $ATLASCLOUD_API_KEY"
227# Returns: { "code": 200, "data": { "status": "completed", "outputs": ["https://...video-url..."] } }
228
229# Step 3: Download
230curl -o output.mp4 "VIDEO_URL_FROM_OUTPUTS"
231```
232
233### Image-to-Video Example (Wan 2.6)
234
235```bash
236curl -s -X POST "https://api.atlascloud.ai/api/v1/model/generateVideo" \
237 -H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
238 -H "Content-Type: application/json" \
239 -d '{
240 "model": "alibaba/wan-2.6/image-to-video",
241 "image": "https://example.com/landscape.jpg",
242 "prompt": "The camera slowly zooms in as clouds drift across the sky and leaves rustle in the wind",
243 "resolution": "1080p",
244 "duration": 5,
245 "generate_audio": true
246 }'
247```
248
249### Video-to-Video Example (Wan 2.6)
250
251```bash
252curl -s -X POST "https://api.atlascloud.ai/api/v1/model/generateVideo" \
253 -H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
254 -H "Content-Type: application/json" \
255 -d '{
256 "model": "alibaba/wan-2.6/video-to-video",
257 "videos": ["https://example.com/original-video.mp4"],
258 "prompt": "Transform character1 into a cartoon anime character, keep the background unchanged",
259 "size": "1280*720",
260 "duration": 5,
261 "shot_type": "single_camera"
262 }'
263```
264
265### Audio-Guided Generation Example (Wan 2.6)
266
267```bash
268curl -s -X POST "https://api.atlascloud.ai/api/v1/model/generateVideo" \
269 -H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
270 -H "Content-Type: application/json" \
271 -d '{
272 "model": "alibaba/wan-2.6/text-to-video",
273 "prompt": "A jazz band performing on stage, musicians playing saxophone and piano",
274 "audio": "https://example.com/jazz-music.mp3",
275 "size": "1920*1080",
276 "duration": 10
277 }'
278```
279
280### Text-to-Image Example (Wan 2.6)
281
282```bash
283curl -s -X POST "https://api.atlascloud.ai/api/v1/model/generateImage" \
284 -H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
285 -H "Content-Type: application/json" \
286 -d '{
287 "model": "alibaba/wan-2.6/text-to-image",
288 "prompt": "A cyberpunk cityscape at night, neon signs reflected in rain puddles, photorealistic",
289 "size": "1680*720",
290 "enable_prompt_expansion": true
291 }'
292# Returns: { "code": 200, "data": { "id": "prediction-id" } }
293```
294
295### Image Editing Example (Wan 2.6)
296
297```bash
298curl -s -X POST "https://api.atlascloud.ai/api/v1/model/generateImage" \
299 -H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
300 -H "Content-Type: application/json" \
301 -d '{
302 "model": "alibaba/wan-2.6/image-edit",
303 "prompt": "Change the background to a sunset beach scene, keep the person unchanged",
304 "images": ["https://example.com/photo.jpg"],
305 "size": "1280*720"
306 }'
307```
308
309### Image-to-Video Flash Example (Wan 2.6)
310
311```bash
312curl -s -X POST "https://api.atlascloud.ai/api/v1/model/generateVideo" \
313 -H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
314 -H "Content-Type: application/json" \
315 -d '{
316 "model": "alibaba/wan-2.6/image-to-video-flash",
317 "image": "https://example.com/portrait.jpg",
318 "prompt": "The person slowly turns and smiles",
319 "resolution": "720p",
320 "duration": 5
321 }'
322```
323
324### Polling Logic
325
326- `processing` / `starting` / `running` → wait 5s, retry (typically takes ~30-120s for video, ~5-10s for image)
327- `completed` / `succeeded` → done, get URL from `data.outputs[]`
328- `failed` → error, read `data.error`
329
330### Atlas Cloud MCP Tools (if available)
331
332If the Atlas Cloud MCP server is configured, use built-in tools:
333
334```
335atlas_generate_video(model="alibaba/wan-2.6/text-to-video", params={...})
336atlas_generate_image(model="alibaba/wan-2.6/text-to-image", params={...})
337atlas_get_prediction(prediction_id="...")
338```
339
340---
341
342## Implementation Guide
343
3441. **Determine task type**:
345 - Text-to-video: user describes a scene/action in text → **2.6 T2V** or **2.5 T2V**
346 - Image-to-video: user provides an image to animate → **2.6 I2V** or **2.6 I2V Flash** (budget)
347 - Video-to-video: user wants to transform an existing video → **2.6 V2V**
348 - Text-to-image: user wants to generate an image → **2.6 T2I**
349 - Image editing: user wants to modify existing images → **2.6 Image Edit**
350
3512. **Choose model version**:
352 - **Wan 2.6** (recommended): Latest generation, best quality, multi-camera, audio-guided, V2V
353 - **Wan 2.6 Flash**: Budget I2V at $0.018/s — ideal for drafts
354 - **Wan 2.5**: Cost-effective at $0.035/s flat rate, supports 480p
355
3563. **Extract parameters**:
357 - Prompt: describe scene, action, camera movement
358 - Negative prompt: exclude undesired elements ("blurry, distorted, watermark")
359 - Resolution: 480p for drafts, 720p default, 1080p for final output
360 - Duration: 5s default, up to 15s for 2.6, up to 10s for 2.5
361 - Shot type (2.6 only): `multi_camera` for dynamic shots, `single_camera` for stable framing
362 - Audio: provide URL for audio-guided generation, or set `generate_audio: true`
363 - Prompt expansion: set `enable_prompt_expansion: true` for auto-optimized prompts
364
3654. **Execute**: POST to generateVideo/generateImage API → poll result → download
366
3675. **Present result**: show file path, offer to play/open
368
369## Prompt Tips
370
371- **Scene + Action**: "A samurai draws his sword in a bamboo forest at dawn, mist rising from the ground"
372- **Camera direction**: "Camera slowly dollies forward...", "Aerial tracking shot of...", "First-person POV walking through..."
373- **Multi-camera**: Use `shot_type: "multi_camera"` with prompts like "Cut between close-up and wide shot..."
374- **V2V character control**: Reference characters as `character1`, `character2` — e.g., "Transform character1 into an anime character"
375- **Audio-guided**: Provide an audio URL to sync video with music, dialogue, or sound effects
376- **Negative prompts**: "blurry, low quality, distorted faces, watermark, text overlay"
377
378---
379
380## Model Comparison
381
382| Feature | Wan 2.6 | Wan 2.5 |
383|---------|:-------:|:-------:|
384| Video T2V Price (720p) | $0.08/s | $0.035/s |
385| Video I2V Price (720p) | $0.10/s | $0.035/s |
386| Max Resolution | 1080p | 1080p |
387| Max Duration | 15s | 10s |
388| Shot Type Control | Yes | No |
389| Audio-Guided | Yes | Yes |
390| Video-to-Video | Yes | No |
391| Text-to-Image | Yes ($0.021) | No |
392| Image Editing | Yes ($0.021) | No |
393| Flash/Fast Variants | I2V Flash ($0.018/s) | Yes |
394| Prompt Expansion | Yes | Yes |