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écification | Vidéo Wan 2.7 |
|---|---|
| Fournisseur | Alibaba / Wan |
| ID de modèle CometAPI | wan2.7 |
| Identifiants natifs texte‑vers‑vidéo | wan2.7-t2v, wan2.7-t2v-2026-06-12 |
| Identifiant natif image‑vers‑vidéo | wan2.7-i2v-2026-04-25 |
| Entrées principales | Texte ; image, audio ou vidéo dans les workflows pris en charge |
| Sortie principale | Vidéo générée avec comportement audio pris en charge |
| Modes | T2V, I2V, R2V, édition vidéo, première/dernière image, continuation |
| Résolution | 720P et 1080P |
| Durée T2V | 2 à 15 secondes ; 5 secondes par défaut |
| Ratios d’aspect T2V | 16:9, 9:16, 1:1, 4:3, 3:4 |
| Limite de prompt | 5 000 caractères pour Wan 2.7 T2V natif |
| Limite de prompt négatif | 500 caractères |
| Formats et limites audio | WAV/MP3 ; 2 à 30 secondes ; jusqu’à 15 Mo |
| Invocation | Asynchrone |
| Architecture / nombre de paramètres | Non 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.
| Preuve | Résultat public | Comment l’interpréter |
|---|---|---|
| Design Arena vidéo‑vers‑vidéo | Classé premier ; Elo 1335 (image publiée) | Preuve solide de préférence V2V |
| Spécifications API officielles | 720P/1080P ; 2–15 secondes pour T2V | Flexibilité de production, pas un classement de qualité |
| Score T2V standardisé | Non divulgué publiquement | Utiliser un test A/B interne |
| Score I2V standardisé | Non divulgué publiquement | Utiliser un test A/B interne |
| Benchmark de latence ou taux de succès | Non standardisé publiquement | Mesurer 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

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ètre | Type | Obligatoire | Exemple | Objectif |
|---|---|---|---|---|
| model | string | Oui | wan2.7 | Sélectionne la route |
| prompt | string | Oui | Scene description | Définit le contenu, le mouvement et le style |
| seconds | integer | Non | 5 | Contrôle la durée et le coût |
| size | string | Non | 1280x720 | Contrôle la résolution / le ratio |
| input_reference | file | I2V | reference.png | Fournit une image source |
| Authorization | header | Oui | Bearer token | Authentifie la requête |
Correspondance des paramètres entre CometAPI et l’API native Alibaba
| Concept | CometAPI | API native Alibaba |
|---|---|---|
| Modèle | wan2.7 | wan2.7-t2v ou wan2.7-i2v-* |
| Durée | seconds | duration |
| Résolution | size | resolution plus ratio |
| Image de référence | input_reference | media[].type=first_frame |
| Identifiant de tâche | GET /v1/videos/{id} | output.task_id |
| Statut de tâche | GET /v1/videos/{id} | Point de requête de tâche du fournisseur |
| Résultat binaire | GET /v1/videos/{id}/content | URL 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ésolution | Prix / seconde | 5 secondes | 10 secondes | 15 secondes |
|---|---|---|---|---|
| 720p | 0,08 $ | 0,40 $ | 0,80 $ | 1,20 $ |
| 1080p | 0,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.
| Dimension | Wan 2.7 | Seedance 2.5 | Vidu Q3 | Veo 3.1 |
|---|---|---|---|---|
| Positionnement principal | Suite multimodale contrôlable | Génération narrative plus longue et riche en références | Création narrative rapide | Vidéo cinématique avec audio natif |
| Texte‑vers‑vidéo | Oui | Oui | Oui | Oui |
| Image‑vers‑vidéo | Oui | Oui | Oui | Oui |
| Contrôle première/dernière image | Support natif de la famille | Dépend de la route | Pris en charge | Pris en charge dans certains workflows |
| Continuation vidéo | Support natif de la famille | Orienté édition | Dépend de la route | Workflows d’extension |
| Audio | Guidage d’entrée + BGM/SFX automatique | Audio‑vidéo conjoint | Audio synchronisé natif | Audio synchronisé natif |
| Durée courante de route | 2–15 s T2V natif | 4–30 s route listée | 1–16 s route listée | Modes officiels 4/6/8 s |
| Résolution maximale courante | 1080p | Dépend de la route | 1080p | 1080p ; d’autres variantes peuvent différer |
| Meilleur usage | Workflows de production contrôlés | Récits multi‑plans plus longs | Itération narrative rapide | Plans 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ôme | Cause probable | Correctif recommandé |
|---|---|---|
| 401 Unauthorized | Clé manquante, invalide ou révoquée | Vérifier le jeton Bearer et la variable d’environnement |
| 400 Bad Request | Champ, taille ou durée non pris en charge | Partir de l’exemple de la page modèle et ajouter les champs un à un |
| Pas d’ID de tâche | Wrapper de réponse inattendu | Consigner la réponse complète et vérifier data, id et task_id |
| En file d’attente longtemps | Charge ou capacité du fournisseur | Continuer le sondage borné ; ne pas dupliquer la tâche |
| Generation failed | Erreur média, prompt, policy ou fournisseur | Inspecter la charge utile terminale avant de décider de réessayer |
| MP4 vide | Té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ée | Format, dimensions, taille ou nombre de médias | Convertir en PNG/JPEG et suivre les limites live de la route |
| Coût inattendu | Longue durée, haute résolution ou réessais | Prototyper en 720p et suivre le taux de sorties acceptées |
| Résultat incohérent | Génération stochastique ou prompt de mouvement vague | Spé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.
