Wan 2.5 API
Alibaba Wan 2.5 — texte vers vidéo et image vers vidéo jusqu'à 1080p avec audio synchronisé, plus video-extend, image-edit et text-to-image dans la même famille, avec des variantes Fast des endpoints vidéo.
Ce guide de l'API Wan 2.5 présente les endpoints disponibles sur WaveSpeedAI : texte vers vidéo, image vers vidéo et video-extend avec variantes Fast, image-edit et text-to-image. Le Playground, les exemples, les tarifs et les exemples d'API ci-dessous utilisent les endpoints Wan 2.5 actifs.
Présentation
À propos de Wan 2.5 API
Ce que fait Wan 2.5, sa place dans la gamme de modèles Alibaba, et pourquoi les équipes l’adoptent.
Wan 2.5 est un modèle de génération vidéo proposé par Alibaba, disponible via l’API REST de WaveSpeedAI. Alibaba Wan 2.5 — texte vers vidéo et image vers vidéo jusqu'à 1080p avec audio synchronisé, plus video-extend, image-edit et text-to-image dans la même famille, avec des variantes Fast des endpoints vidéo.
Ce guide de l'API Wan 2.5 présente les endpoints disponibles sur WaveSpeedAI : texte vers vidéo, image vers vidéo et video-extend avec variantes Fast, image-edit et text-to-image. Le Playground, les exemples, les tarifs et les exemples d'API ci-dessous utilisent les endpoints Wan 2.5 actifs.
La famille Wan 2.5 sur WaveSpeedAI propose 8 points d’accès REST couvrant les workflows Image-To-Image, Text-To-Image, Video-Extend, Text-To-Video, Image-To-Video. Chaque variante a ses propres tarifs, paramètres et exemples de résultats — choisissez celle qui correspond à votre type d’entrée et à vos contraintes de production, ou appelez-en plusieurs avec la même clé API pour composer des pipelines en plusieurs étapes.
Exécutez Wan 2.5 avec la même clé API, le même compte de facturation et les mêmes limites de débit que pour les plus de 1 000 autres modèles IA de WaveSpeedAI. Pas de configuration fournisseur distincte, pas de SDK par fournisseur, pas de limites de débit par fournisseur — une seule intégration couvre tout, du texte vers image et du texte vers vidéo à la synthèse audio, la génération 3D, l’agrandissement et l’édition.
Caractéristiques
Capacités de Wan 2.5 API et état de sortie
Les détails propres au modèle que les développeurs recherchent avant de choisir une API : disponibilité, durée de sortie attendue, prise en charge des références et alternative active actuelle.
Disponibilité
Disponible maintenant
Les endpoints Wan 2.5 sont disponibles dans le catalogue WaveSpeedAI : texte vers vidéo, image vers vidéo et video-extend (chacun avec une variante Fast), image-edit et text-to-image, tous sur le même flux de prédiction REST.
Résolutions
480p, 720p, 1080p
La sortie vidéo est disponible en 480p, 720p et 1080p selon l'endpoint ; texte vers vidéo propose des tailles paysage et portrait pour chacune.
Durée
3 à 10 secondes
Texte vers vidéo génère des clips de 5 ou 10 secondes ; image vers vidéo Fast et video-extend génèrent de 3 à 10 secondes.
Audio
Audio synchronisé
Les endpoints vidéo génèrent un audio synchronisé avec l'image, et un fichier audio optionnel (WAV ou MP3, d'au moins 3 secondes, jusqu'à 15 MB) peut guider la génération.
Variantes Fast
Texte, image et prolongation
Wan 2.5 Fast est disponible pour texte vers vidéo, image vers vidéo et video-extend, positionné pour une génération plus rapide et plus abordable.
Outils image
Édition et text-to-image
image-edit accepte jusqu'à deux images d'entrée avec un prompt, et text-to-image génère des images fixes dans la même famille que les endpoints vidéo.
Points d’accès
Tous les points d’accès de l’API Wan 2.5
8 points d’accès Wan 2.5 disponibles dès maintenant sur WaveSpeedAI — choisissez la variante qui correspond à votre workflow.
/filters:quality(82)/media/images/20260408104220_jymu91ex.webp)
Wan 2.5 Image Edit
Refine existing visuals with WAN 2.5 image-edit using prompt-driven adjustments and stylistic upgrades for photos and graphics. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104211_97h9m7p7.webp)
Wan 2.5 Text To Image
WAN 2.5 Text-to-Image turns text prompts into AI-generated images with the WAN 2.5 model for on-demand image creation. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104203_64hpvi1b.webp)
Wan 2.5 Video Extend Fast
WAN 2.5 Fast is an AI-powered video extender that turns short clips into longer videos while preserving audio tracks for seamless extensions. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104158_jzbs7q2h.webp)
Wan 2.5 Video Extend
WAN 2.5 Video-Extend turns short clips into longer videos with preserved or generated synchronized audio for continuity. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104214_334vajy7.webp)
Wan 2.5 Text To Video
WAN 2.5 makes 480p-1080p text/image-to-video with synced audio and is faster, more affordable than Google Veo3. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104222_y5iz96kb.webp)
Wan 2.5 Text To Video Fast
WAN 2.5 Fast creates synchronized-audio videos from text or images in 720p, faster and more affordable than Google Veo3. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104205_99s4gqxu.webp)
Wan 2.5 Image To Video Fast
WAN 2.5 Fast converts text or images into synchronized-audio videos in 480p, 720p, or 1080p, offering faster, more affordable generation compared to Google Veo3. REST API, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104159_4c1hr4ym.webp)
Wan 2.5 Image To Video
WAN 2.5 converts text or images into videos (480p/720p/1080p) with synced audio, faster and more affordable than Google Veo3. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Exemples
Wan 2.5 en action
De vrais résultats générés par l’API Wan 2.5. Survolez une vidéo pour la prévisualiser, cliquez pour ouvrir la visionneuse en taille réelle.
Mode d’emploi
Comment utiliser l’API Wan 2.5
Quatre étapes de l’inscription à une génération terminée. Des exemples complets en Python, Node.js et cURL se trouvent dans la section API ci-dessous.
- 01
Obtenez une clé API
Créez un compte WaveSpeedAI et copiez votre clé API depuis le tableau de bord. Les nouveaux comptes reçoivent des crédits de démarrage gratuits — de quoi utiliser le playground quelques dizaines de fois avant le début de la facturation.
- 02
Soumettez une prédiction
Envoyez votre entrée en JSON par POST à https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video. Le point d’accès renvoie immédiatement un identifiant de prédiction — les générations sont asynchrones, vous ne gardez donc pas de connexion ouverte pendant l’inférence.
- 03
Interrogez jusqu’à la fin
GET https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. Retournez les outputs sur completed ; arrêtez avec une erreur sur failed, cancelled, timeout ou deleted ; continuez d’interroger pour tout autre statut.
- 04
Lisez l’URL du résultat
Une fois le statut "completed", lisez l’URL dans data.outputs[0]. Elle pointe vers votre média généré sur le CDN de WaveSpeedAI — fichier image, vidéo, audio ou 3D selon la variante Wan 2.5 appelée.
Cas d’usage
Ce que vous pouvez créer avec Wan 2.5
Les workflows courants pour lesquels développeurs et créateurs utilisent l’API Wan 2.5.
Texte vers vidéo avec audio synchronisé
alibaba/wan-2.5/text-to-video transforme un prompt en clip de 5 ou 10 secondes jusqu'à 1080p, avec un audio généré en même temps que l'image.
Image vers vidéo à partir d'une image fixe
alibaba/wan-2.5/image-to-video et la variante Fast animent une image de référence avec un prompt, en 720p ou 1080p et de 3 à 10 secondes sur l'endpoint Fast.
Prolonger un clip
alibaba/wan-2.5/video-extend poursuit une vidéo existante avec un audio synchronisé conservé ou généré, en 480p, 720p ou 1080p, et la variante Fast fait de même à moindre coût.
Guider un clip avec votre propre audio
Transmettez un fichier audio aux endpoints vidéo pour orienter la génération, par exemple une ligne de voix ou un rythme que le mouvement doit suivre.
Éditer des images dans la même famille
alibaba/wan-2.5/image-edit applique des modifications pilotées par prompt à une ou deux images, de sorte que les images fixes et les clips proviennent d'une même famille de modèles.
Images fixes avec text-to-image
alibaba/wan-2.5/text-to-image génère des images à partir d'un prompt, avec une taille définie en pixels jusqu'à 2880.
Conseils
Conseils pour rédiger vos prompts avec Wan 2.5
Des conseils pratiques pour obtenir de meilleurs résultats avec Wan 2.5 — tirés des pratiques qui fonctionnent sur les modèles vidéo dans les pipelines de production.
- 01
Prototypez en Fast, livrez sur l'endpoint standard
Utilisez les variantes Fast pour tester prompts et mouvement, puis lancez l'endpoint standard pour le clip final.
- 02
Choisissez la taille selon la plateforme
Texte vers vidéo propose des tailles paysage et portrait en 480p, 720p et 1080p ; choisissez la taille selon l'endroit où le clip sera lu avant de générer.
- 03
Utilisez l'audio pour guider le timing
Un court fichier WAV ou MP3 d'au moins 3 secondes peut guider la génération, ce qui aide lorsque le mouvement doit suivre une ligne de voix ou un rythme.
- 04
Prolongez par petites étapes
Avec video-extend, prolongez un clip de quelques secondes à la fois et décrivez ce qui se passe ensuite, afin que chaque étape garde la scène et l'audio continus.
Tarifs
Tarifs de l’API Wan 2.5
La tarification se fait par résultat. Le montant final dépend des paramètres définis dans le playground de chaque variante (résolution, durée, nombre de résultats, références).
| Point d’accès | Type | Prix de départ |
|---|---|---|
| alibaba/ | image-to-image | $0.035 |
| alibaba/ | text-to-image | $0.03 |
| alibaba/ | video-extend | $0.068 |
| alibaba/ | video-extend | $0.10 |
| alibaba/ | text-to-video | $0.10 |
| alibaba/ | text-to-video | $0.068 |
| alibaba/ | image-to-video | $0.068 |
| alibaba/ | image-to-video | $0.10 |
API
Appelez l’API Wan 2.5
Obtenez une clé API sur wavespeed.ai/accesskey, puis soumettez une prédiction via REST. Le playground génère des exemples prêts à copier pour toute combinaison d’entrées.
POSThttps://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-d '{
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"size": "1280*720",
"duration": 5,
"enable_prompt_expansion": false
}')
TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
-H "Authorization: Bearer $WAVESPEED_API_KEY")
RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
case "$STATUS" in
completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
*) sleep 2 ;;
esac
doneconst submitUrl = "https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
async function requestJson(url, options = {}) {
const response = await fetch(url, options);
if (!response.ok) throw new Error(await response.text());
return response.json();
}
// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"size": "1280*720",
"duration": 5,
"enable_prompt_expansion": false
}),
});
const task = body.data ?? body;
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;
// 2. Poll until the prediction finishes.
while (true) {
const resultBody = await requestJson(resultUrl, {
headers: { "Authorization": `Bearer ${apiKey}` },
});
const result = resultBody.data ?? resultBody;
if (result.status === "completed") {
console.log(result.outputs);
break;
}
if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
await new Promise(resolve => setTimeout(resolve, 2000));
}import json
import os
import time
from urllib.request import Request, urlopen
api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"size": "1280*720",
"duration": 5,
"enable_prompt_expansion": False
}
def request_json(url, data=None):
request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
with urlopen(request) as response:
return json.load(response)
# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video", json.dumps(payload).encode())
task = body.get("data", body)
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"
# 2. Poll until the prediction finishes.
while True:
result_body = request_json(result_url)
result = result_body.get("data", result_body)
status = result.get("status")
if status == "completed":
print(result.get("outputs", []))
break
if status in {"failed", "cancelled", "timeout", "deleted"}:
raise RuntimeError(result)
time.sleep(2)Comparer
Wan 2.5 face aux alternatives
Quand choisir Wan 2.5 plutôt que des modèles similaires sur WaveSpeedAI.
Wan 2.5 vs Wan 2.7
Wan 2.7 est la génération plus récente, avec reference-to-video, video-edit et une sortie 1080p sur davantage d'endpoints. Wan 2.5 reste une option avec des variantes Fast et un audio synchronisé.
Wan 2.5 vs Veo 3.1
Le catalogue présente Wan 2.5 comme plus rapide et plus abordable que Google Veo 3, avec génération guidée par l'audio et video-extend. Veo 3.1 propose les niveaux Standard, Fast et Lite en 1080p.
Wan 2.5 vs Kling 2.6
Kling 2.6 ajoute le contrôle du mouvement et un endpoint create-voice. Wan 2.5 couvre de 480p à 1080p avec audio synchronisé, video-extend, image-edit et text-to-image dans une seule famille.
FAQ
Wan 2.5 API — Questions fréquentes
Tarifs, licence, intégration — les questions courantes sur l’utilisation de Wan 2.5 sur WaveSpeedAI.
Quelles résolutions Wan 2.5 prend-il en charge ?
Les endpoints vidéo produisent du 480p, 720p et 1080p selon l'endpoint. Texte vers vidéo propose aussi des tailles portrait, et image vers vidéo Fast produit du 720p ou du 1080p.
Wan 2.5 génère-t-il de l'audio ?
Oui. Les endpoints vidéo produisent un audio synchronisé avec l'image, et vous pouvez envoyer un fichier audio optionnel pour orienter le résultat.
Qu'est-ce que Wan 2.5 Fast ?
Des variantes Fast de texte vers vidéo, image vers vidéo et video-extend, positionnées pour une génération plus rapide et plus abordable que les variantes standard.
Puis-je prolonger une vidéo existante avec Wan 2.5 ?
Oui. L'endpoint video-extend prolonge un court clip en un clip plus long, avec un audio synchronisé conservé ou généré, et dispose d'une variante Fast.
Qu’est-ce que l’API Wan 2.5 ?
Wan 2.5 est un modèle Alibaba de génération vidéo exposé sous forme d’API REST sur WaveSpeedAI. Alibaba Wan 2.5 — texte vers vidéo et image vers vidéo jusqu'à 1080p avec audio synchronisé, plus video-extend, image-edit et text-to-image dans la même famille, avec des variantes Fast des endpoints vidéo. Vous pouvez l’appeler par programmation ou l’essayer depuis le playground indiqué ci-dessus.
Comment appeler l’API Wan 2.5 ?
Créez un compte WaveSpeedAI, copiez votre clé API depuis /accesskey, puis envoyez votre entrée en JSON par POST à https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video. Le point d’accès renvoie un identifiant de prédiction. Interrogez le point d’accès de résultat environ toutes les 2 secondes, augmentez l’intervalle pour les tâches longues et arrêtez-vous à tout statut final. Des exemples Python / Node.js / cURL orientés production figurent ci-dessus.
Combien coûte l’API Wan 2.5 ?
Wan 2.5 démarre à $0.03 par exécution. Le coût exact dépend des paramètres définis (résolution, durée, nombre de résultats, références). L’estimation en direct à côté du bouton Générer dans le playground affiche le prix exact pour votre saisie actuelle.
Quelles variantes de Wan 2.5 sont disponibles ?
WaveSpeedAI héberge 8 points d’accès Wan 2.5 actifs : alibaba/wan-2.5/image-edit, alibaba/wan-2.5/text-to-image, alibaba/wan-2.5/video-extend-fast, alibaba/wan-2.5/video-extend, alibaba/wan-2.5/text-to-video, alibaba/wan-2.5/text-to-video-fast, alibaba/wan-2.5/image-to-video-fast, alibaba/wan-2.5/image-to-video. Chaque variante a sa propre page playground et ses propres tarifs.
Puis-je utiliser commercialement les résultats de Wan 2.5 ?
Les droits d’usage commercial suivent la licence du modèle Alibaba. La plupart des modèles Alibaba autorisent l’usage commercial des résultats ; consultez la page playground de chaque modèle pour le résumé de sa licence, et les Conditions d’utilisation de WaveSpeedAI pour les conditions au niveau de la plateforme.
Pourquoi utiliser Wan 2.5 sur WaveSpeedAI plutôt qu’en direct ?
Une seule clé API et un seul compte de facturation pour Wan 2.5 ET plus de 1 000 autres modèles IA d’autres fournisseurs. Pas de configuration de SDK par fournisseur, pas de limites de débit distinctes, pas de code d’intégration à réécrire pour chaque fournisseur. Les tarifs sont généralement au niveau de l’API directe de Alibaba, ou en dessous.
Fournisseur
À propos de Alibaba
L’équipe derrière Wan 2.5 et la gamme plus large de modèles Alibaba sur WaveSpeedAI.
Le laboratoire Tongyi d'Alibaba produit la famille de modèles vidéo Wan et la famille de LLM Qwen. Wan se distingue par sa publication en open weights, sa large couverture de variantes (texte vers vidéo, image vers vidéo, référence vers vidéo, video-edit, video-extend, image-edit, texte vers image) et sa solidité constante en stabilité du mouvement et en respect du prompt, y compris avec des prompts multilingues.
Commencez à créer avec Wan 2.5 sur WaveSpeedAI
Crédits de démarrage gratuits à l’inscription. Une seule clé API pour plus de 1 000 modèles IA de Alibaba et de tous les autres fournisseurs.