Wan API
Comprehensive video and image suite — text-to-video, image-to-video, video editing, and storyboards.
curl -X POST https://runapi.ai/api/v1/wan/image_to_video \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "wan-2.7-text-to-video",
"image_url": "https://cdn.runapi.ai/public/samples/image.jpg",
"prompt": "Generate a 5-second video of a cat jumping onto a bookshelf, natural indoor lighting, handheld camera feel."
}'
import { WanClient } from "@runapi.ai/wan";
const client = new WanClient();
const result = await client.imageToVideo.run({
model: "wan-2.7-text-to-video",
image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
prompt: "Generate a 5-second video of a cat jumping onto a bookshelf, natural indoor lighting, handheld camera feel.",
});
<?php
require __DIR__ . "/vendor/autoload.php";
use RunApi\Wan\WanClient;
$client = new WanClient();
$result = $client->imageToVideo->run([
'model' => 'wan-2.7-text-to-video',
'image_url' => 'https://cdn.runapi.ai/public/samples/image.jpg',
'prompt' => 'Generate a 5-second video of a cat jumping onto a bookshelf, natural indoor lighting, handheld camera feel.',
]);
require "runapi/wan"
client = RunApi::Wan::Client.new
result = client.image_to_video.run(
model: "wan-2.7-text-to-video",
image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
prompt: "Generate a 5-second video of a cat jumping onto a bookshelf, natural indoor lighting, handheld camera feel."
)
npx skills add runapi-ai/wan -g
# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor
Wan is Alibaba's comprehensive video and image generation suite covering text-to-video, image-to-video, video editing, speech-to-video, and storyboard generation. It spans multiple model versions optimized for quality, speed, and specialized creative tasks.
- Più varianti per diversi livelli di velocità / qualità
- Il model skill include documentazione, schema e note di setup
- Funziona con workflow di sviluppo app
- Le generazioni fallite non vengono addebitate
Confronta tutte le varianti API
| Variant | Billing | From | |
|---|---|---|---|
| wan-2.2-a14b-image-to-video-turbo | call | $0.400 | Visualizza → |
| wan-2.2-a14b-speech-to-video-turbo | second | $0.240 | Visualizza → |
| wan-2.2-a14b-text-to-video-turbo | call | $0.400 | Visualizza → |
| wan-2.2-animate-move | second | $0.130 | Visualizza → |
| wan-2.2-animate-replace | second | $0.130 | Visualizza → |
| wan-2.5-image-to-video | second | $0.120 | Visualizza → |
| wan-2.5-text-to-video | second | $0.120 | Visualizza → |
| wan-2.6-edit-video | second | $0.140 | Visualizza → |
| wan-2.6-flash-edit-video | call | $0.300 | Visualizza → |
| wan-2.6-flash-image-to-video | call | $0.300 | Visualizza → |
| wan-2.6-image-to-video | second | $0.140 | Visualizza → |
| wan-2.6-text-to-video | second | $0.140 | Visualizza → |
| wan-2.7-edit-video | second | $0.160 | Visualizza → |
| wan-2.7-image | call | $0.050 | Visualizza → |
| wan-2.7-image-pro | call | $0.120 | Visualizza → |
| wan-2.7-image-to-video | second | $0.160 | Visualizza → |
| wan-2.7-r2v | second | $0.160 | Visualizza → |
| wan-2.7-text-to-video | second | $0.160 | Visualizza → |
Installa lo skill Wan per lo sviluppo di app
Carica documentazione del modello, schema, note prezzi e passaggi di setup nel tuo workspace di codice.
# Install the model skill for app development workflows
npx skills add runapi-ai/wan -g
Install the Wan skill for this app: 1. Add runapi-ai/wan with the skills installer. 2. Load SKILL.md in this workspace. 3. Use its docs, schemas, pricing notes, and setup steps when adding model features. 4. Confirm the install path when done.
Dal model skill al primo risultato in quattro passaggi
Scegli il modello
Seleziona modello e variante adatti al tipo di output, al livello qualità e alla latenza target.
Configura
Imposta la tua chiave RunAPI e installa il model skill nel workspace di codice.
Implementa
Usa le istruzioni dello skill per aggiungere la feature modello dentro la tua applicazione.
Ricevi
Interroga per task ID, usa streaming dove supportato o gestisci il callback webhook.
Che cos'è l'API Wan?
Wan is Alibaba's full-spectrum video and image model suite, one of the most complete open-weight video families available. Through RunAPI, all Wan versions share a single key and unified billing.
Perché usare l'API Wan tramite RunAPI
Un’unica autenticazione, tutti i provider
Una sola chiave RunAPI sblocca l’intero catalogo. Niente account separati, niente rotazione delle chiavi per integrazione.
Prezzi e billing unificati
Prezzi per chiamata in USD, fatturati mensilmente. Le generazioni fallite non vengono addebitate.
Skill con schema
Schema tipizzati e note di setup sono inclusi nel model skill, così l'implementazione parte dal contratto corretto.
Domande frequenti
How many Wan versions are available?
Versions 2.2, 2.5, 2.6, and 2.7, each adding new capabilities. 2.7 is the latest with first-and-last-frame control and multi-reference video generation.
What is speech-to-video?
The speech-to-video endpoint on Wan 2.2 takes audio input and generates video with lip-synced motion driven by the speech content.
Does Wan support video editing?
Yes — Wan 2.6+ includes video editing and Wan 2.7 adds a dedicated video editing endpoint with subject and camera control.
Is Wan open source?
Partly — Wan 2.1 and 2.2 are released as open weights under the Apache 2.0 license. The later versions (2.5, 2.6, and 2.7) are closed, API-only models.
What is the R2V endpoint?
Wan 2.7 R2V uses the text-to-video endpoint with reference image, video, and audio inputs to anchor a character's appearance and voice across clips.
Da quale variante dovrei iniziare?
Scegli la variante più economica che soddisfa il tuo livello di qualità. La maggior parte dei team inizia con la variante veloce e passa alla pro per la produzione.
C’è un piano gratuito?
I nuovi account ricevono le prime chiamate gratuite su ogni modello. Dopo, paghi per chiamata.
Trasmettete i risultati in streaming?
Dove lo streaming è disponibile, RunAPI trasmette end-to-end.
Come vengono addebitati i fallimenti?
Le generazioni non riuscite non vengono addebitate.
Gli output vengono memorizzati nella cache?
Gli output generati vengono salvati e recuperabili tramite ID del task. Gli input non vengono memorizzati nella cache.
Posso usarlo a fini commerciali?
Sì — l’uso commerciale è incluso per ogni variante, salvo che una licenza del modello lo limiti esplicitamente; in tal caso è indicato nella pagina della variante.
E i limiti di rate limit?
I rate limit per chiave scalano in base al tier di utilizzo. Vedi la pagina prezzi per i limiti aggiornati.
Dove posso segnalare problemi?
Apri un issue nel repo GitHub pubblico oppure scrivi al supporto.
Se ti piace l'API Wan, prova questi
Inizia a sviluppare con l'API Wan.
- Wan wan-2.2-a14b-image-to-video-turbo
- Wan wan-2.2-a14b-speech-to-video-turbo
- Wan wan-2.2-a14b-text-to-video-turbo
- Wan wan-2.2-animate-move
- Wan wan-2.2-animate-replace
- Wan wan-2.5-image-to-video
- Wan wan-2.5-text-to-video
- Wan wan-2.6-edit-video
- Wan wan-2.6-flash-edit-video
- Wan wan-2.6-flash-image-to-video
- Wan wan-2.6-image-to-video
- Wan wan-2.6-text-to-video
- Wan wan-2.7-edit-video
- Wan wan-2.7-image
- Wan wan-2.7-image-pro
- Wan wan-2.7-image-to-video
- Wan wan-2.7-r2v
- Wan wan-2.7-text-to-video