Guide API Wan 2.7 : Text-to-Video, Image-to-Video, Reference Video et Video Edit — Manuel d'intégration complet

Résumé

• Wan 2.7, c'est quatre modèles en un seul endpoint. Text-to-video, image-to-video (avec contrôle first/last frame), vidéo de référence multi-personnages (avec clonage vocal), et édition vidéo basée sur des instructions — le tout via POST /v1/videos/generations.
• Tarifs sur EvoLink : $0.086/sec en 720p, $0.144/sec en 1080p. Un clip de 10 secondes en 720p coûte $0.86. Pas d'abonnement.
• IDs de modèle : wan2.7-text-to-video, wan2.7-image-to-video, wan2.7-reference-video, wan2.7-video-edit.
• Workflow asynchrone. Chaque requête retourne immédiatement un ID de tâche. Interrogez GET /v1/tasks/\{task_id\} pour le statut. Les URLs vidéo expirent en 24 heures.
• Ce que Wan 2.7 ajoute par rapport à Wan 2.6 sur EvoLink : L'édition vidéo via la route Wan 2.7, le contrôle first-and-last-frame en I2V, et la vidéo de référence multi-personnages avec clonage vocal.
• Les tâches échouées ne sont pas facturées pour les modes reference-video et video-edit.

Table des matières

1. Démarrage rapide : votre première vidéo Wan 2.7 en 60 secondes
2. Choisir le bon ID de modèle
3. Mode 1 : Text-to-video
4. Mode 2 : Image-to-video avec contrôle de frame
5. Mode 3 : Vidéo de référence avec clonage vocal
6. Mode 4 : Édition vidéo
7. Tarifs et calcul des coûts
8. Workflow asynchrone et gestion des tâches
9. Gestion des erreurs et codes de statut courants
10. Patterns de production et garde-fous
11. Migration de Wan 2.6 vers Wan 2.7
12. Aide-mémoire des paramètres
13. FAQ

1. Démarrage rapide : votre première vidéo Wan 2.7 en 60 secondes

Étape 1 : Générer une vidéo

curl -X POST https://api.evolink.ai/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-text-to-video",
    "prompt": "A drone shot over a misty mountain lake at sunrise, slow camera push forward, cinematic color grading",
    "quality": "720p",
    "aspect_ratio": "16:9",
    "duration": 5
  }'

{
  "id": "task-unified-1757169743-7cvnl5zw",
  "status": "pending",
  "created": 1757169743
}

Étape 2 : Interroger le résultat

curl https://api.evolink.ai/v1/tasks/task-unified-1757169743-7cvnl5zw \
  -H "Authorization: Bearer YOUR_API_KEY"

Étape 3 : C'est tout

2. Choisir le bon ID de modèle

3. Mode 1 : Text-to-video

Fonctionnement

Génère une vidéo à partir d'un prompt texte. Prend en charge un audio de pilotage optionnel pour la synchronisation labiale ou une sortie synchronisée avec la musique. Génère automatiquement une musique de fond lorsqu'aucun audio n'est fourni.

Paramètres clés

Narration multi-plans

Contrôlez la structure des plans directement dans le prompt :

{
  "model": "wan2.7-text-to-video",
  "prompt": "A tense detective story. Shot 1 [0-3s] wide angle: rainy night street, neon lights. Shot 2 [3-6s] medium: detective enters old building. Shot 3 [6-9s] close-up: detective's determined eyes. Shot 4 [9-12s] medium: cautious advance through dim corridor. Shot 5 [12-15s] close-up: discovers key clue.",
  "aspect_ratio": "16:9",
  "duration": 15
}

Avec audio de pilotage

{
  "model": "wan2.7-text-to-video",
  "prompt": "A cartoon general in golden armor on a horse, reciting a classical poem",
  "audio_urls": ["https://your-cdn.com/recital.mp3"],
  "duration": 10
}

4. Mode 2 : Image-to-video avec contrôle de frame

Fonctionnement

Trois modes de génération

Combinaisons d'entrées valides

1. image_start uniquement
2. image_start + audio_urls
3. image_start + image_end
4. image_start + image_end + audio_urls
5. video_urls (continuation)
6. video_urls + image_end (continuation avec frame final)

Toute autre combinaison sera rejetée.

Exemple : First-and-last-frame

curl -X POST https://api.evolink.ai/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image-to-video",
    "generation_mode": "first_last_frame",
    "prompt": "A product bottle rotating 360 degrees with soft studio lighting",
    "image_start": "https://your-cdn.com/bottle-front.jpg",
    "image_end": "https://your-cdn.com/bottle-back.jpg",
    "quality": "1080p",
    "duration": 5
  }'

Exemple : Continuation vidéo

{
  "model": "wan2.7-image-to-video",
  "generation_mode": "video_continuation",
  "prompt": "The scene continues with the character walking toward the sunset",
  "video_urls": ["https://your-cdn.com/previous-clip.mp4"],
  "image_end": "https://your-cdn.com/sunset-ending.jpg",
  "duration": 5
}

5. Mode 3 : Vidéo de référence avec clonage vocal

Fonctionnement

Génère de nouvelles scènes vidéo tout en préservant l'apparence des personnages à partir d'images ou de vidéos de référence — et clone optionnellement leur voix à partir d'un court échantillon audio. C'est ainsi que vous construisez des séries vidéo multi-personnages où chaque personne a un aspect et une voix cohérents d'un épisode à l'autre.

Contraintes clés

• image_urls + video_urls combinés : maximum 5 éléments au total
• image_start et l'audio vocal ne comptent pas dans cette limite de 5 éléments
• Durée : 2-15 sec (références images uniquement), 2-10 sec (avec références vidéo)
• Facturation : durée vidéo d'entrée + durée vidéo de sortie. Les tâches échouées sont gratuites.

Indexation des personnages dans les prompts

Référencez les personnages par leur position dans les tableaux d'entrée :

• Anglais : Image 1, Image 2, Video 1, Video 2
• Chinois : 图1, 图2, 视频1, 视频2

Clonage vocal : deux méthodes

Mappage clé-valeur précis entre les références de personnages et l'audio vocal :

{
  "model": "wan2.7-reference-video",
  "prompt": "Image 1 holds Image 2 and says: 'What lovely sunshine today'",
  "image_urls": [
    "https://your-cdn.com/girl.jpg",
    "https://your-cdn.com/toy.png"
  ],
  "model_params": {
    "voice_bindings": {
      "image1": "https://your-cdn.com/girl-voice.mp3"
    }
  },
  "duration": 10
}

Exemple : Vidéo de marque multi-personnages

{
  "model": "wan2.7-reference-video",
  "prompt": "Image 1 and Image 2 are having a conversation in a modern office. Image 1 explains the product while Image 2 takes notes. The scene is professional and well-lit.",
  "image_urls": [
    "https://your-cdn.com/spokesperson-a.jpg",
    "https://your-cdn.com/spokesperson-b.jpg"
  ],
  "image_start": "https://your-cdn.com/office-wide-shot.jpg",
  "model_params": {
    "voice_bindings": {
      "image1": "https://your-cdn.com/voice-a.mp3",
      "image2": "https://your-cdn.com/voice-b.mp3"
    }
  },
  "quality": "1080p",
  "duration": 10
}

Storyboard multi-grille

Pour les références à image unique avec plusieurs panneaux (par ex. une grille 3×3 de poses de personnages) :

{
  "model": "wan2.7-reference-video",
  "prompt": "Reference image. 3D cartoon style. 1. Wide shot of fantasy forest. 2. Boy parts the vines. 3. Robot scans ahead. 4. Close-up of map. 5. Boy's excited face. 6. They leap over roots.",
  "image_urls": ["https://your-cdn.com/storyboard-grid.png"],
  "duration": 15
}

6. Mode 4 : Édition vidéo

Fonctionnement

Paramètres clés

Exemple : Changement de style par instruction seule

curl -X POST https://api.evolink.ai/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-video-edit",
    "prompt": "Convert the entire scene to a vintage film look with warm color grading and film grain",
    "video_urls": ["https://your-cdn.com/source-clip.mp4"],
    "keep_original_sound": true,
    "duration": 0
  }'

Exemple : Remplacement de vêtements guidé par référence

{
  "model": "wan2.7-video-edit",
  "prompt": "Replace the girl's outfit with the clothes from the reference image",
  "video_urls": ["https://your-cdn.com/source.mp4"],
  "image_urls": ["https://your-cdn.com/target-outfit.png"]
}

Ce que vous pouvez éditer

• Transfert de style : "convertir en style anime", "appliquer un effet aquarelle"
• Changement d'arrière-plan : "changer l'arrière-plan pour une rue de Tokyo sous la pluie la nuit"
• Changement d'objet/vêtement : "passer la veste en rouge", "remplacer le chapeau par une couronne"
• Colorisation : "convertir ce métrage noir et blanc en couleur"
• Éclairage : "passer l'éclairage en heure dorée"

7. Tarifs et calcul des coûts

Tarifs EvoLink Wan 2.7

Pas d'abonnement, pas d'engagement minimum. Vous ne payez que pour les vidéos générées avec succès.

Comparaison des coûts avec d'autres fournisseurs (selon les pages fournisseurs, mai 2026)

Facturation spéciale pour reference-video et video-edit

Formule d'estimation de budget

8. Workflow asynchrone et gestion des tâches

Chaque requête Wan 2.7 suit le même pattern asynchrone :

Cycle de vie d'une tâche

URL de callback (webhook)

Bonnes pratiques de production

1. Persistez l'ID de tâche immédiatement après la soumission. Si votre service plante, vous pouvez récupérer.
2. Utilisez un backoff exponentiel pour l'interrogation. Commencez à 5 secondes, plafonnez à 30 secondes.
3. Téléchargez et archivez les résultats immédiatement. Les URLs vidéo expirent en 24 heures.
4. Rendez les soumissions idempotentes. Hachez les payloads de requête et dédupliquez pour éviter la double facturation lors de tempêtes de retry.

9. Gestion des erreurs et codes de statut courants

Erreurs courantes

• Mauvaise orthographe de l'ID de modèle. C'est wan2.7-text-to-video, pas wan-2.7-text-to-video ou wan27-t2v. Un ID de modèle obsolète retourne un 404 propre sans message d'erreur utile.
• Envoyer des combinaisons média invalides en mode I2V. Consultez le tableau des combinaisons d'entrées valides.
• Ne pas télécharger les résultats à temps. Les URLs vidéo expirent en 24 heures. Intégrez un téléchargement automatique dans votre pipeline.

10. Patterns de production et garde-fous

Garde-fous budgétaires

Patterns de fiabilité

• Retry avec clé d'idempotence. Hachez votre payload de requête et vérifiez les tâches existantes avant de resoumettre.
• Gestion des timeouts. Si une tâche n'est pas terminée après 5 minutes, marquez-la pour revue manuelle plutôt que de resoumettre à l'aveugle.
• Stratégie de repli. Envisagez un repli vers Wan 2.6 ou Wan 2.5 si Wan 2.7 retourne des erreurs persistantes sur un mode spécifique.
• Validation des assets. Validez les dimensions d'image, la durée vidéo et le format audio avant soumission. Les assets défectueux causent des échecs qui ressemblent à des problèmes de qualité du modèle.

Architecture de file d'attente

Pour les systèmes de production générant plus de 100 vidéos/jour :

N'appelez jamais l'API directement depuis les handlers de requêtes côté utilisateur. Passez toujours par un système de jobs en arrière-plan.

11. Migration de Wan 2.6 vers Wan 2.7

Ce qui ne change pas

• Endpoint API : POST /v1/videos/generations
• Authentification : même clé API et Bearer token
• Pattern asynchrone : même ID de tâche / polling / callback
• Facturation EvoLink : même compte et système de crédits

Ce qui change

Migration étape par étape

1. Changer le paramètre model. Remplacez wan2.6-text-to-video par wan2.7-text-to-video (idem pour les autres modes).
2. Tester avec les prompts existants. Wan 2.7 gère le même format de prompt. Aucune réécriture nécessaire.
3. Adopter les nouvelles fonctionnalités progressivement. Ajoutez generation_mode, image_end, voice_bindings, ou video-edit selon les besoins de votre workflow.
4. Garder Wan 2.6 en repli. Les deux versions fonctionnent en parallèle sur EvoLink. Vous n'avez pas à tout migrer d'un coup.

12. Aide-mémoire des paramètres

Paramètres partagés (tous les modes)

Spécifiques au text-to-video

Spécifiques à l'image-to-video

Spécifiques à la vidéo de référence

Spécifiques à l'édition vidéo

13. FAQ

Combien coûte Wan 2.7 sur EvoLink ?

$0.086/sec en 720p, $0.144/sec en 1080p. Un clip de 10 secondes en 720p coûte $0.86. Pas d'abonnement ni d'engagement minimum.

Quelle est la différence entre Wan 2.7 et Wan 2.6 ?

Sur EvoLink, Wan 2.7 expose l'édition vidéo, la vidéo de référence multi-personnages avec clonage vocal, et le contrôle first-and-last-frame en mode I2V. Wan 2.6 reste utile pour la narration cinématographique et les variantes Flash pour une itération plus rapide. Les deux fonctionnent en parallèle sur EvoLink.

Wan 2.7 génère-t-il automatiquement l'audio ?

Les tâches échouées sont-elles facturées ?

Pour les modes reference-video et video-edit, les tâches échouées ne sont explicitement pas facturées. Pour text-to-video et image-to-video, la facturation est basée sur la durée vidéo réellement générée.

Puis-je utiliser Wan 2.7 pour du contenu NSFW ?

Quels formats audio sont pris en charge pour le clonage vocal ?

Comment gérer l'expiration des URLs vidéo ?

Les URLs vidéo expirent après 24 heures. Intégrez une étape automatique de téléchargement et archivage dans votre pipeline immédiatement après la fin de la tâche. Stockez l'asset final dans votre propre CDN ou stockage objet.

Puis-je migrer de Wan 2.6 sans interruption ?

Prochaines étapes

• Essayer le playground : Page du modèle Wan 2.7
• Comparer les modèles Wan : Collection de la famille Wan API
• Détail complet des tarifs : Guide des tarifs Wan API
• Patterns de production Wan 2.6 : Guide API Wan 2.6
• Review de Wan 2.5 : Review API Wan 2.5