MiniMax-M3.1-Flash and DeepSeek-V4.1-Flash-1017 are now live on CometAPI →
guide/Recherche CometAPI

Comment utiliser l'API Wan 2.7 : guide complet pour les développeurs

Apprenez à utiliser l’API Wan 2.7 via CometAPI pour la génération texte-vers-vidéo et image-vers-vidéo, avec des exemples, des tarifs, des comparaisons et des bonnes pratiques.

CometAPI
Mia MarenÉquipe de recherche sur les modèles IA et API
Mis à jour Sep 3, 2026 22 min de lecture
Comment utiliser l'API Wan 2.7 : guide complet pour les développeurs
Utiliser ce modèle

Passez le premier appel API.

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_COMETAPI_KEY",
    base_url="https://api.cometapi.com/v1",
)

response = client.chat.completions.create(
    model="gpt-5-mini",
    messages=[{"role": "user", "content": "Build this workflow."}],
)

print(response.choices[0].message.content)

Réponse rapide

Wan 2.7 est une suite multimodale de génération vidéo d’Alibaba pour les workflows texte-vers‑vidéo, image‑vers‑vidéo, génération guidée par référence et édition. Via Wan 2.7 sur CometAPI, les développeurs utilisent l’ID de modèle wan2.7 avec le point de terminaison asynchrone POST /v1/videos. L’intégration comprend trois étapes opérationnelles : soumettre une tâche, interroger l’ID vidéo renvoyé, puis télécharger le MP4 finalisé. La route live prend en charge une sortie 720p et 1080p et affiche un tarif à la seconde ; la durée et la résolution déterminent donc le coût estimé de génération. Commencez par une requête texte‑vers‑vidéo de 5 secondes en 720p, validez le workflow, puis ajoutez des références image ou une résolution supérieure uniquement après validation de la route de base.

Important scope: Ce guide couvre Wan 2.7 Video via CometAPI. Il ne décrit pas le modèle d’image Wan distinct ; les spécifications image‑seules comme la sortie image fixe 4K ne sont donc pas considérées comme des capacités de Wan 2.7 Video.

Principaux points à retenir

  • CometAPI expose Wan 2.7 via un point de terminaison vidéo asynchrone de style OpenAI plutôt qu’une réponse de chat synchrone.
  • La route utilise l’ID de modèle wan2.7 et POST /v1/videos.
  • Une intégration complète doit conserver l’ID vidéo renvoyé, interroger le point de terminaison de statut, gérer les échecs terminaux et ne télécharger le MP4 qu’après succès.
  • L’API texte‑vers‑vidéo native de Wan 2.7 d’Alibaba prend en charge 720P et 1080P avec une durée de 2 à 15 secondes ; la route CometAPI utilise ses propres noms de champs unifiés.
  • Les workflows image‑vers‑vidéo, première/dernière image et continuation existent dans la famille native d’Alibaba, mais les champs avancés exposés via la route unifiée doivent être vérifiés dans la documentation live de la route.
  • Les preuves de benchmark public sont les plus solides pour la vidéo‑vers‑vidéo : Wan 2.7 a dominé la catégorie Design Arena. Ce résultat ne doit pas être généralisé à chaque tâche texte‑vers‑vidéo ou image‑vers‑vidéo.
  • La métrique de production la plus utile est le coût par clip accepté, et non le seul prix par seconde générée.

Qu’est‑ce que Wan 2.7 ?

Wan 2.7 en termes simples pour développeurs

Wan 2.7 n’est pas simplement un modèle prompt‑vers‑vidéo. Alibaba décrit une famille vidéo en quatre volets couvrant Wan2.7-t2v, Wan2.7-i2v, Wan2.7-r2v et Wan2.7-videoedit. Ensemble, ces variantes couvrent la génération à partir de texte, l’animation à partir d’images, le contrôle piloté par référence (sujet ou style) et la transformation de vidéo existante. Cela compte pour la conception d’application : un simple clip marketing peut n’utiliser que le texte‑vers‑vidéo, tandis qu’une chaîne de production à identité de personnage cohérente peut nécessiter des entrées de référence, des images d’ancrage, un guidage audio et une édition itérative.

Sur CometAPI, la route compresse volontairement la nomenclature spécifique au fournisseur dans l’ID de modèle client wan2.7. La capacité de génération sous‑jacente reste Wan 2.7, mais l’authentification, les chemins d’API et les noms de paramètres diffèrent de l’API native Alibaba Cloud.

Spécifications techniques de Wan 2.7

SpécificationVidéo Wan 2.7
FournisseurAlibaba / Wan
ID de modèle CometAPIwan2.7
Identifiants natifs texte‑vers‑vidéowan2.7-t2v, wan2.7-t2v-2026-06-12
Identifiant natif image‑vers‑vidéowan2.7-i2v-2026-04-25
Entrées principalesTexte ; image, audio ou vidéo dans les workflows pris en charge
Sortie principaleVidéo générée avec comportement audio pris en charge
ModesT2V, I2V, R2V, édition vidéo, première/dernière image, continuation
Résolution720P et 1080P
Durée T2V2 à 15 secondes ; 5 secondes par défaut
Ratios d’aspect T2V16:9, 9:16, 1:1, 4:3, 3:4
Limite de prompt5 000 caractères pour Wan 2.7 T2V natif
Limite de prompt négatif500 caractères
Formats et limites audioWAV/MP3 ; 2 à 30 secondes ; jusqu’à 15 Mo
InvocationAsynchrone
Architecture / nombre de paramètresNon confirmée de manière exhaustive dans la documentation API officielle

Specification boundary: Certaines pages de catalogue décrivent une architecture ou un nombre de paramètres, mais la documentation officielle de l’API vidéo d’Alibaba ne publie pas une spécification d’architecture complète pour chaque variante Wan 2.7. La formulation éditoriale la plus sûre est que le nombre total de paramètres et l’architecture ne sont pas divulgués de manière exhaustive.

Que peut faire Wan 2.7 ?

Texte‑vers‑vidéo avec prompts multi‑plans chronométrés.

Wan 2.7 peut interpréter des changements de plan écrits directement dans un prompt. Un développeur peut décrire Plan 1, Plan 2 et Plan 3 avec des plages temporelles au lieu de s’appuyer sur un champ de contrôle de plans distinct. Le prompt devient ainsi un storyboard compact.

Contrôle de la première et de la dernière image.

Le workflow image‑vers‑vidéo natif accepte des médias de première image et de dernière image pour que le modèle synthétise le mouvement entre deux ancrages visuels. C’est utile pour des transitions produit, des changements de pose et des morphings de scène.

Continuation de vidéo.

Une entrée native de type first_clip conditionne la portion suivante de la vidéo. Dans ce workflow, la durée doit être interprétée selon les règles de la tâche du fournisseur ; les applications ne doivent pas supposer qu’elle désigne toujours uniquement le segment nouvellement généré.

Génération guidée par l’audio.

Alibaba documente l’audio comme source motrice pour le timing et le lip‑sync. Sans ressource audio téléversée, le modèle peut générer une musique de fond ou des effets sonores correspondants. L’audio plus long que la vidéo demandée est tronqué ; un audio plus court laisse le reste de la vidéo silencieuse.

Extension de prompt, prompts négatifs et filigranage.

L’API native prend en charge la réécriture de prompt, les prompts négatifs et une option de filigrane généré par IA. Ces contrôles aident les équipes à standardiser la qualité des prompts et le comportement de provenance, bien que les champs unifiés de CometAPI ne correspondent pas nécessairement un‑à‑un.

Que disent les benchmarks publics sur Wan 2.7 ?

Les modèles vidéo n’ont pas de benchmark universellement accepté équivalent à un score MMLU ou SWE‑bench pour les LLM. Pour Wan 2.7, le signal externe publié le plus clair est qu’il a dominé la catégorie Design Arena vidéo‑vers‑vidéo. L’image de classement de la publication officielle montre Wan 2.7 avec un Elo de 1335 à cet instantané. Cela étaye une affirmation de préférence en transformation et édition vidéo ; cela ne prouve pas un leadership universel en texte‑vers‑vidéo, image‑vers‑vidéo, qualité audio ou latence.

PreuveRésultat publicComment l’interpréter
Design Arena vidéo‑vers‑vidéoClassé premier ; Elo 1335 (image publiée)Preuve solide de préférence V2V
Spécifications API officielles720P/1080P ; 2–15 secondes pour T2VFlexibilité de production, pas un classement de qualité
Score T2V standardiséNon divulgué publiquementUtiliser un test A/B interne
Score I2V standardiséNon divulgué publiquementUtiliser un test A/B interne
Benchmark de latence ou taux de succèsNon standardisé publiquementMesurer sur la route sélectionnée

Conclusion sur les benchmarks

  • Utilisez le résultat Design Arena comme preuve de compétitivité en vidéo‑vers‑vidéo, pas comme affirmation générale pour tous les modes.
  • Ne réutilisez pas les chiffres de benchmark de Wan 2.1 comme résultats de Wan 2.7.
  • Pour la sélection en production, testez les mêmes prompts, ressources sources, résolution, durée et conditions audio sur les modèles.
  • Suivez le taux d’acceptation humaine, la stabilité du mouvement, la préservation de l’identité, la latence, le taux d’échec et le coût par clip accepté.

Pourquoi utiliser Wan 2.7 via CometAPI ?

Une API vidéo unifiée

CometAPI expose le modèle via un cycle de vie vidéo asynchrone commun. La page modèle actuelle de Wan 2.7 publie l’ID de modèle client, le tarif de la route et un schéma fonctionnel créer‑sonder‑télécharger. Cela réduit la quantité de code d’intégration spécifique au fournisseur lorsqu’un produit doit tester ou router entre plusieurs modèles vidéo.

POST /v1/videos GET  /v1/videos/{video_id} GET  /v1/videos/{video_id}/content

Comment utiliser l'API Wan 2.7 : guide complet pour les développeurs

Cycle de vie créer‑sonder‑télécharger de CometAPI pour la génération vidéo asynchrone. Source des points de terminaison : Documentation API CometAPI**.

  • Une clé API pour plusieurs modèles vidéo pris en charge.
  • Un schéma cohérent pour la création de tâche, la récupération de statut et le téléchargement de fichier.
  • Visibilité centralisée de l’usage et de la facturation.
  • Moins de code applicatif lié à l’authentification et au schéma de réponse d’un seul fournisseur.
  • A/B testing plus rapide car la sélection de modèle peut changer sans remplacer tout le cycle de vie des tâches.

Une note de compatibilité nécessaire

Route compatibility: Le schéma /v1/videos unifié de CometAPI n’expose pas nécessairement tous les champs des API natives T2V, I2V, R2V et d’édition vidéo d’Alibaba Cloud. Le texte‑vers‑vidéo et l’image‑vers‑vidéo de base sont les points de départ les plus sûrs. Avant de livrer le contrôle première/dernière image, les entrées multi‑références, le pilotage audio ou l’édition vidéo, vérifiez les champs et limites média exacts de la route live.

Ce dont vous avez besoin avant de commencer

Créez un compte CometAPI et une clé API

Créez ou connectez‑vous à un compte CometAPI, puis générez une clé API. Stockez‑la dans une variable d’environnement. Ne codez pas la clé en dur dans le contrôle de source, du code navigateur ou des applications mobiles.

export COMETAPI_KEY="your_api_key"$env:COMETAPI_KEY="your_api_key"

Connaître l’ID de modèle et les points de terminaison

Model ID: wan2.7 Create endpoint: POST https://api.cometapi.com/v1/videos Status endpoint: GET https://api.cometapi.com/v1/videos/{video_id} Download endpoint: GET https://api.cometapi.com/v1/videos/{video_id}/content

Installer le paquet Python

python -m pip install --upgrade requests

Les exemples utilisent des requêtes HTTP brutes car les formulaires multipart, le sondage de statut et les téléchargements binaires sont plus faciles à comprendre sans une couche SDK supplémentaire.

Comment utiliser l’API Wan 2.7 avec CometAPI

Étape 1 : Créer une tâche texte‑vers‑vidéo

Envoyez une requête multipart contenant le modèle, le prompt, la durée et la taille. Cet exemple de 5 secondes en 720p est la manière la moins risquée de valider les identifiants, le routage et la création de tâche.

curl https://api.cometapi.com/v1/videos \  -H "Authorization: Bearer $COMETAPI_KEY" \  -F "model=wan2.7" \  -F "prompt=A cinematic tracking shot of a futuristic train crossing a snowy mountain valley at sunrise, smooth camera motion, realistic light." \  -F "seconds=5" \  -F "size=1280x720"The response should include a task identifier under id or task_id. Log the full response during integration because providers and route versions may wrap status data differently.{  "id": "video_task_id",  "status": "queued",  "progress": 0 }

Étape 2 : Sonder le statut de la vidéo

Utilisez l’ID renvoyé dans le point de terminaison de statut. Un sondage toutes les 10–15 secondes est généralement plus approprié que des boucles serrées pour une tâche vidéo à forte intensité de calcul.

curl https://api.cometapi.com/v1/videos/{video_id} \  -H "Authorization: Bearer $COMETAPI_KEY"{  "id": "video_task_id",  "status": "in_progress",  "progress": 45 }

Votre application doit traiter completed ou success comme des états terminaux réussis, et failed, error ou FAILURE comme des états terminaux échoués. Conservez la charge utile complète d’échec pour le diagnostic.

Étape 3 : Télécharger le MP4 complété

Téléchargez uniquement après que la tâche a atteint un état terminal réussi. Enregistrer une réponse issue d’une tâche incomplète peut créer un fichier vide ou un document d’erreur avec une extension MP4.

curl https://api.cometapi.com/v1/videos/{video_id}/content \  -H "Authorization: Bearer $COMETAPI_KEY" \  --output wan2_7_output.mp4

Étape 4 : Générer une vidéo à partir d’une image

Pour l’image‑vers‑vidéo, téléversez la référence en formulaire multipart et utilisez un prompt décrivant le mouvement, le comportement de la caméra et le changement temporel souhaité. La route unifiée utilise couramment input_reference. Confirmez ses règles actuelles de taille de fichier, de format et de nombre d’images avant la production.

curl https://api.cometapi.com/v1/videos \  -H "Authorization: Bearer $COMETAPI_KEY" \  -F "model=wan2.7" \  -F "prompt=The camera slowly pushes forward while the subject turns toward the warm window light; preserve identity, clothing and background composition." \  -F "input_reference=@reference.png" \  -F "seconds=5" \  -F "size=1280x720"

Astuce pour le prompt image : Ne consacrez pas l’essentiel du prompt à redécrire un contenu statique déjà visible dans la référence. Utilisez le budget de prompt pour le mouvement, la direction de la caméra, le timing, les changements et les contraintes.

Étape 5 : Construire le workflow Python complet

Le programme suivant valide la clé API, soumet une tâche, normalise les réponses de statut encapsulées, applique un temps d’attente maximal, gère les échecs terminaux et télécharge le fichier finalisé.

import os import time from pathlib import Path​ import requests​ API_KEY = os.environ.get("COMETAPI_KEY") BASE_URL = "https://api.cometapi.com/v1" POLL_INTERVAL = 12 MAX_WAIT_SECONDS = 900​ if not API_KEY:    raise RuntimeError("Set COMETAPI_KEY before running this script.")​ headers = {"Authorization": f"Bearer {API_KEY}"}​ def parse_task_data(payload):    return payload.get("data") or payload​ # 1. Submit the generation task. submit = requests.post(    f"{BASE_URL}/videos",    headers=headers,    files={        "model": (None, "wan2.7"),        "prompt": (            None,            "A cinematic tracking shot of a futuristic train "            "crossing a snowy mountain valley at sunrise."        ),        "seconds": (None, "5"),        "size": (None, "1280x720"),    },    timeout=60, ) submit.raise_for_status() submit_payload = submit.json() video_id = submit_payload.get("id") or submit_payload.get("task_id")​ if not video_id:    raise RuntimeError(f"No video ID in response: {submit_payload}")​ print(f"Created video task: {video_id}")​ # 2. Poll until a terminal state or timeout. deadline = time.monotonic() + MAX_WAIT_SECONDS while time.monotonic() < deadline:    response = requests.get(        f"{BASE_URL}/videos/{video_id}",        headers=headers,        timeout=30,    )    response.raise_for_status()    payload = response.json()    data = parse_task_data(payload)    status = str(data.get("status", "unknown"))    progress = data.get("progress", "unknown")    print(f"status={status}, progress={progress}")​    if status in {"completed", "success"} or progress in {100, "100", "100%"}:        break    if status in {"failed", "error", "FAILURE"}:        raise RuntimeError(f"Video generation failed: {payload}")​    time.sleep(POLL_INTERVAL) else:    raise TimeoutError(f"Task {video_id} exceeded {MAX_WAIT_SECONDS}s")​ # 3. Download the completed MP4. video = requests.get(    f"{BASE_URL}/videos/{video_id}/content",    headers=headers,    timeout=180, ) video.raise_for_status()​ output = Path("output") / f"{video_id}.mp4" output.parent.mkdir(parents=True, exist_ok=True) output.write_bytes(video.content)​ if output.stat().st_size == 0:    raise RuntimeError("Downloaded file is empty.")​ print(f"Saved {output} ({output.stat().st_size} bytes)")

Étape 6 : Appeler Wan 2.7 avec JavaScript

Cet exemple Node.js utilise fetch et FormData intégrés. Utilisez Node.js 18 ou ultérieur ; l’exemple écrit le résultat avec node:fs/promises.

import { mkdir, writeFile } from "node:fs/promises";​ const apiKey = process.env.COMETAPI_KEY; const baseUrl = "https://api.cometapi.com/v1"; const pollIntervalMs = 12_000; const maxWaitMs = 15 * 60 * 1000;​ if (!apiKey) throw new Error("Set COMETAPI_KEY first.");​ const headers = { Authorization: `Bearer ${apiKey}` }; const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));​ const form = new FormData(); form.append("model", "wan2.7"); form.append(  "prompt",  "A cinematic tracking shot of a futuristic train crossing " +    "a snowy mountain valley at sunrise." ); form.append("seconds", "5"); form.append("size", "1280x720");​ const submitResponse = await fetch(`${baseUrl}/videos`, {  method: "POST",  headers,  body: form, }); if (!submitResponse.ok) throw new Error(await submitResponse.text());​ const submitPayload = await submitResponse.json(); const videoId = submitPayload.id || submitPayload.task_id; if (!videoId) throw new Error(`No video ID: ${JSON.stringify(submitPayload)}`);​ const deadline = Date.now() + maxWaitMs; while (Date.now() < deadline) {  const statusResponse = await fetch(`${baseUrl}/videos/${videoId}`, { headers });  if (!statusResponse.ok) throw new Error(await statusResponse.text());​  const payload = await statusResponse.json();  const data = payload.data || payload;  const status = String(data.status || "unknown");  const progress = data.progress ?? "unknown";  console.log({ status, progress });​  if (["completed", "success"].includes(status) || [100, "100", "100%"].includes(progress)) {    break;  }  if (["failed", "error", "FAILURE"].includes(status)) {    throw new Error(`Generation failed: ${JSON.stringify(payload)}`);  }  await sleep(pollIntervalMs); }​ if (Date.now() >= deadline) throw new Error(`Task ${videoId} timed out.`);​ const videoResponse = await fetch(`${baseUrl}/videos/${videoId}/content`, { headers }); if (!videoResponse.ok) throw new Error(await videoResponse.text());​ await mkdir("output", { recursive: true }); const outputPath = `output/${videoId}.mp4`; await writeFile(outputPath, Buffer.from(await videoResponse.arrayBuffer())); console.log(`Saved ${outputPath}`);

Quels sont les paramètres de l’API Wan 2.7 ?

ParamètreTypeObligatoireExempleObjectif
modelstringOuiwan2.7Sélectionne la route
promptstringOuiScene descriptionDéfinit le contenu, le mouvement et le style
secondsintegerNon5Contrôle la durée et le coût
sizestringNon1280x720Contrôle la résolution / le ratio
input_referencefileI2Vreference.pngFournit une image source
AuthorizationheaderOuiBearer tokenAuthentifie la requête

Correspondance des paramètres entre CometAPI et l’API native Alibaba

ConceptCometAPIAPI native Alibaba
Modèlewan2.7wan2.7-t2v ou wan2.7-i2v-*
Duréesecondsduration
Résolutionsizeresolution plus ratio
Image de référenceinput_referencemedia[].type=first_frame
Identifiant de tâcheGET /v1/videos/{id}output.task_id
Statut de tâcheGET /v1/videos/{id}Point de requête de tâche du fournisseur
Résultat binaireGET /v1/videos/{id}/contentURL de résultat temporaire / réponse fournisseur

Ce mapping explique pourquoi des exemples copiés depuis Alibaba Cloud ne peuvent pas être collés tels quels dans CometAPI. La capacité du modèle est liée, mais la couche d’accès et le schéma diffèrent.

Comment rédiger de meilleurs prompts Wan 2.7 : exemples

Un prompt vidéo pratique définit ce qui doit rester stable et ce qui doit changer dans le temps. Utilisez cette structure :

Subject + action + environment + camera movement + lighting + visual style + timeline + audio direction + constraints

Prompt plan unique

A red vintage roadster drives along a wet coastal highway at blue hour. The camera tracks low beside the front wheel, then rises smoothly to reveal ocean cliffs. Realistic reflections, restrained motion blur, cinematic 35mm look, no text or logos.

Prompt multi‑plans

Create a cinematic detective sequence with consistent character identity. Shot 1 [0-2s]: a rain-soaked city street at night, neon reflected in puddles. Shot 2 [2-4s]: the detective enters an old building; slow handheld follow shot. Shot 3 [4-5s]: close-up of a clue under a narrow flashlight beam. Preserve the same coat, face and lighting palette across all shots. No captions.

Prompt image‑vers‑vidéo

Preserve the subject's face, clothing and background layout. The subject looks up, turns slightly toward the window and takes one step forward. Slow camera push-in, warm light gradually increases, natural hair and fabric motion, no new objects.

Recommandations pour les prompts négatifs

Utilisez les prompts négatifs pour supprimer les modes d’échec récurrents plutôt que pour décrire une seconde fois la scène souhaitée. Une liste concise telle que low resolution, deformed hands, duplicated limbs, flicker, unstable face, unreadable text et watermark est généralement plus utile qu’un long paragraphe contradictoire.

Combien coûte l’API Wan 2.7 ?

La route CometAPI actuelle liste Wan 2.7 à 0,08 $ par seconde pour 720p et 0,12 $ par seconde pour 1080p. Le coût estimé est donc une fonction directe de la durée générée et de la résolution sélectionnée.

RésolutionPrix / seconde5 secondes10 secondes15 secondes
720p0,08 $0,40 $0,80 $1,20 $
1080p0,12 $0,60 $1,20 $1,80 $
Estimated video cost = price per second x generated duration in seconds

Source des données : Tarification live du modèle sur CometAPI**.

Pricing interpretation: N’affirmez pas qu’une route agrégatrice est moins chère que Alibaba Cloud sans comparer la même région, variante de modèle, résolution, durée, mode audio et unité de facturation. Le prix clair à la seconde de CometAPI et la facturation unifiée sont des avantages d’intégration ; un avantage de prix fournisseur nécessite une comparaison à base égale.

Un clip 1080p qui échoue à la revue créative coûte plus cher que son prix de génération indiqué car l’équipe doit le régénérer. Pour la planification de production, divisez la dépense totale par le nombre de clips acceptés sans retouche.

Wan 2.7 vs Seedance 2.5 vs Vidu Q3 vs Veo 3.1

Les alternatives les plus utiles sur la même plateforme sont Seedance 2.5, Vidu Q3 et Veo 3.1. Le tableau ci‑dessous compare l’adéquation des workflows plutôt que de désigner un gagnant universel. Les fonctionnalités de route peuvent évoluer, vérifiez donc les entrées avancées avant la production.

DimensionWan 2.7Seedance 2.5Vidu Q3Veo 3.1
Positionnement principalSuite multimodale contrôlableGénération narrative plus longue et riche en référencesCréation narrative rapideVidéo cinématique avec audio natif
Texte‑vers‑vidéoOuiOuiOuiOui
Image‑vers‑vidéoOuiOuiOuiOui
Contrôle première/dernière imageSupport natif de la familleDépend de la routePris en chargePris en charge dans certains workflows
Continuation vidéoSupport natif de la familleOrienté éditionDépend de la routeWorkflows d’extension
AudioGuidage d’entrée + BGM/SFX automatiqueAudio‑vidéo conjointAudio synchronisé natifAudio synchronisé natif
Durée courante de route2–15 s T2V natif4–30 s route listée1–16 s route listéeModes officiels 4/6/8 s
Résolution maximale courante1080pDépend de la route1080p1080p ; d’autres variantes peuvent différer
Meilleur usageWorkflows de production contrôlésRécits multi‑plans plus longsItération narrative rapidePlans cinématiques haut de gamme

Résultats de la comparaison

  • Choisissez Wan 2.7 lorsque le contrôle première/dernière image, la continuation, le guidage audio et un workflow large et contrôlable priment sur la longueur maximale d’un clip.
  • Choisissez Seedance 2.5 lorsque des récits multi‑plans plus longs et une création riche en références sont prioritaires.
  • Choisissez Vidu Q3 lorsque l’itération narrative rapide, l’audio synchronisé et des workflows orientés créateurs sont centraux.
  • Choisissez Veo 3.1 lorsque la qualité cinématique, le réalisme visuel et l’audio intégré justifient un coût de route plus élevé.
  • Ne choisissez pas un gagnant sur la base des seules spécifications. Utilisez un jeu fixe de prompts et d’actifs, puis comparez le taux de sortie acceptée et le coût total de production.

Bonnes pratiques de production

Cycle de vie de tâche et fiabilité

  • Conservez l’ID de tâche immédiatement après la création.
  • Utilisez une stratégie d’idempotence dans votre application pour qu’un réessai client ne crée pas de tâches payantes dupliquées.
  • Sondez avec un intervalle de 10–15 secondes et une attente maximale plutôt qu’une boucle sans borne.
  • Différenciez les échecs HTTP transitoires des échecs de génération déclarés par le fournisseur.
  • Utilisez un backoff exponentiel pour les erreurs réseau ou de limite de débit, mais ne réessayez pas aveuglément en cas d’échecs de politique de contenu.
  • Marquez une tâche comme terminée seulement après que la sortie a été téléchargée et validée comme non vide.
  • Ne dépendez pas de manière permanente d’une URL temporaire du fournisseur ; copiez les sorties acceptées dans votre stockage contrôlé lorsque c’est autorisé.

Qualité et maîtrise des coûts

  • Prototyper les prompts en 720p et courte durée avant de générer des masters 1080p.
  • Conservez ensemble le prompt, le prompt négatif, l’ID de modèle, la route, la résolution, la durée, l’ID de tâche et le hachage de sortie pour la reproductibilité.
  • Construisez une grille d’évaluation pour l’adhérence au prompt, le mouvement, la cohérence temporelle, l’identité, les mains, les artefacts textuels, l’audio et la sécurité.
  • Mesurez le coût par sortie acceptée, pas seulement le coût par requête.
  • Maintenez un petit jeu de prompts de régression et réexécutez‑le avant de changer de version de route ou de fournisseur de modèles.

Sécurité et gouvernance

  • Conservez les clés API côté serveur et faites‑les pivoter en cas de suspicion d’exposition.
  • Validez les téléversements d’images et de vidéos avant de les transmettre à la route de génération.
  • Appliquez des contrôles de consentement, de ressemblance et de propriété intellectuelle pour les médias de référence.
  • Ajoutez une revue humaine pour la publicité, l’actualité, la politique, le médical ou d’autres usages à fort impact.
  • Conservez les métadonnées de provenance et appliquez les politiques de filigranage ou de divulgation requises par votre juridiction et votre plateforme.

Erreurs courantes et dépannage

Erreur ou symptômeCause probableCorrectif recommandé
401 UnauthorizedClé manquante, invalide ou révoquéeVérifier le jeton Bearer et la variable d’environnement
400 Bad RequestChamp, taille ou durée non pris en chargePartir de l’exemple de la page modèle et ajouter les champs un à un
Pas d’ID de tâcheWrapper de réponse inattenduConsigner la réponse complète et vérifier data, id et task_id
En file d’attente longtempsCharge ou capacité du fournisseurContinuer le sondage borné ; ne pas dupliquer la tâche
Generation failedErreur média, prompt, policy ou fournisseurInspecter la charge utile terminale avant de décider de réessayer
MP4 videTéléchargé avant achèvement ou corps d’erreur enregistréVérifier le statut et le Content‑Type avant d’écrire le fichier
Référence rejetéeFormat, dimensions, taille ou nombre de médiasConvertir en PNG/JPEG et suivre les limites live de la route
Coût inattenduLongue durée, haute résolution ou réessaisPrototyper en 720p et suivre le taux de sorties acceptées
Résultat incohérentGénération stochastique ou prompt de mouvement vagueSpécifier timing et contraintes ; comparer plusieurs candidats

Recommandation finale

La valeur pratique de Wan 2.7 réside dans l’étendue de son workflow vidéo contrôlable : texte‑vers‑vidéo, animation d’images, images d’ancrage, continuation, génération guidée par référence et comportement conscient de l’audio. Via CometAPI, le chemin le plus rapide consiste à valider une requête de 5 secondes en 720p avec le point de terminaison asynchrone unifié, puis à ajouter des entrées image et une sortie 1080p une fois la création de tâche, le sondage et le téléchargement fiables.

En production, placez les fonctionnalités natives avancées derrière des vérifications explicites de capacités, car le schéma unifié de CometAPI peut ne pas exposer tous les champs d’Alibaba. Comparez Wan 2.7 à des alternatives en utilisant les mêmes prompts et actifs, et sélectionnez la route qui produit le coût le plus bas par vidéo approuvée plutôt que le prix affiché le plus bas.

FAQs

Qu’est‑ce que l’API Wan 2.7 ?

C’est une famille de génération vidéo multimodale accessible par API couvrant texte‑vers‑vidéo, image‑vers‑vidéo, workflows guidés par référence et édition vidéo. CometAPI expose la route client via l’ID de modèle wan2.7.

Quel est l’ID de modèle Wan 2.7 sur CometAPI ?

Utilisez wan2.7. Ne le remplacez pas par des identifiants natifs Alibaba tels que wan2.7-t2v sauf si vous appelez directement Alibaba Cloud.

Quel point de terminaison crée une vidéo Wan 2.7 ?

Envoyez une requête multipart POST à https://api.cometapi.com/v1/videos. Puis interrogez /v1/videos/{video_id} et téléchargez depuis /v1/videos/{video_id}/content.

Wan 2.7 prend‑il en charge texte‑vers‑vidéo et image‑vers‑vidéo ?

Oui. Les deux sont des capacités listées. L’image‑vers‑vidéo ajoute une image de référence et doit utiliser les exigences multipart actuelles de la route.

Quelles résolutions Wan 2.7 prend‑il en charge ?

La route vidéo Wan 2.7 publiée prend en charge 720p et 1080p. La documentation texte‑vers‑vidéo native liste aussi des dimensions de sortie spécifiques au ratio pour les deux niveaux.

Quelle est la durée maximale d’une vidéo Wan 2.7 ?

L’API texte‑vers‑vidéo native de Wan 2.7 d’Alibaba autorise des durées entières de 2 à 15 secondes avec 5 secondes par défaut. Utilisez les valeurs documentées pour la route CometAPI spécifique que vous appelez.

Wan 2.7 génère‑t‑il de l’audio ?

Alibaba documente la génération guidée par l’audio et la musique de fond/les effets sonores automatiques quand l’audio est omis. Les champs audio exacts exposés via une route unifiée doivent être vérifiés avant la production.

Wan 2.7 peut‑il utiliser première et dernière images ?

La famille image‑vers‑vidéo native prend en charge les workflows première image et première + dernière image. Confirmez les champs correspondants de la route unifiée avant d’y compter sur CometAPI.

L’API Wan 2.7 est‑elle synchrone ou asynchrone ?

Elle est asynchrone. La création de tâche renvoie un ID ; votre application doit sonder le statut et télécharger le résultat après achèvement.

Combien coûte Wan 2.7 sur CometAPI ?

La route publiée liste 0,08 $ par seconde pour 720p et 0,12 $ par seconde pour 1080p. Un clip de 5 secondes est donc estimé à 0,40 $ ou 0,60 $ respectivement.

Faut‑il utiliser Wan 2.7, Seedance 2.5, Vidu Q3 ou Veo 3.1 ?

Utilisez Wan 2.7 pour une grande contrôlabilité, Seedance 2.5 pour des récits plus longs riches en références, Vidu Q3 pour une itération narrative rapide et Veo 3.1 pour des sorties cinématiques haut de gamme. Validez le choix avec un A/B test contrôlé.

Wan 2.7 peut‑il continuer une vidéo existante ?

Oui dans la famille de modèles native via un workflow first_clip. La disponibilité et la correspondance des paramètres sur la route unifiée CometAPI doivent être vérifiées.

Continuer à apprendre

Reliez cet article à la décision suivante.

Voir tous les sujets
Publié le Aug 31, 2026
Dernière mise à jour Sep 3, 2026
19 vues
Revu pour la clarté, l'attribution des sources et la terminologie API actuelle.

En savoir plus