Alibaba: Wan 2.7
Alibaba Wan 2.7 crée des vidéos avec du son à partir de texte, d’images de début et de fin ou de références visuelles. Son workflow d’image poursuit aussi un clip source en utilisant la durée totale demandée. Le fabricant annonce du MP4 en 720p ou 1080p à 30 fps : 2–15 secondes pour les modes texte/image et jusqu’à 10 secondes pour la génération à partir de références.
À propos du modèle
Cette description présente les capacités du modèle. Les entrées, sorties et options disponibles dans Ailoot pour la méthode sélectionnée figurent ci-dessous.
Alibaba Wan 2.7 est une famille de génération vidéo avec des profils nommés à partir de texte, d’une image et de références. Le producteur documente des scènes synchronisées avec le son et des narrations à plusieurs plans, tandis que son processus d’images ajoute la génération avec première et dernière image et le prolongement d’une vidéo initiale. Le résultat utile est un court clip avec son audio, par exemple une transition de produit, une histoire compacte ou un prolongement adapté à un plan existant. Choisissez le mode selon les matériaux sources et le contrôle nécessaire sur le début ou la fin.
Pour la génération de vidéo à partir de texte, décrivez le sujet, le décor, l’action, la caméra, le style et le son. Un storyboard peut identifier chaque plan et sa plage temporelle, tandis qu’un brief à plan unique doit préciser que l’action reste continue. Le guide de prompts Wan 2.7 laisse le modèle interpréter la structure des plans à partir du brief écrit au lieu d’utiliser le contrôle shot_type de la version 2.6. L’API textuelle actuelle accepte des prompts en chinois ou en anglais jusqu’à 5 000 caractères, avec un prompt négatif distinct de 500 caractères ; le texte excédentaire est tronqué. Gardez l’action et les contraintes essentielles claires dans cette limite.
La génération à partir d’une première image anime une image d’ouverture fournie. La génération avec première et dernière image définit aussi le point final et le mouvement qui le relie au départ. Le guide d’images 2.7 prend en charge une source audio de pilotage avec ces combinaisons d’images. Préparez des extrémités qui partagent une scène et un sujet prévu, et décrivez la transition au lieu de demander au modèle de réinterpréter les deux images comme des références de style sans lien. La sortie se rapproche des proportions de la première image ; le guide traite la résolution comme un palier de nombre de pixels et arrondit les dimensions encodées en conséquence.
Le prolongement vidéo commence par un clip source et peut aussi utiliser une image de fin. La durée demandée est celle de la vidéo totale renvoyée, segment original compris. L’exemple du guide combine une source de deux secondes avec dix secondes de nouveau contenu pour obtenir douze secondes. Préparez l’action finale de la source et précisez la suite afin que la caméra et le sujet poursuivent une direction cohérente. Vérifiez le raccord pour l’apparence, le mouvement, la lumière et le son au lieu d’évaluer uniquement la nouvelle fin générée.
Le profil actuel de références séparé du producteur utilise des images ou des vidéos pour guider des personnages, des objets ou une scène. Son guide autorise jusqu’à cinq images et vidéos de référence au total et utilise des étiquettes propres au type, telles que Image 1 et Video 1. Décrivez le rôle de chaque matériau et l’interaction souhaitée. Pour une scène guidée par des références, montrez un personnage issu d’une référence qui transporte l’objet d’une autre dans un lieu précisé. Le cadrage par références diffère de la génération à partir d’une première image : le brief peut définir une nouvelle composition au lieu d’exiger que la vidéo commence sur une image fixe fournie.
Pour le son personnalisé dans la génération à partir de texte, les formats documentés sont WAV et MP3, avec une durée de deux à trente secondes et un maximum de 15 Mo. La durée vidéo choisie détermine la partie utilisée : un audio plus long est coupé à cette durée, tandis qu’un audio plus court que la vidéo laisse le reste muet. Préparez le passage audio exact qui appartient au plan et laissez de la place à l’action visuelle souhaitée. Sans fichier audio fourni, le producteur décrit la génération de musique de fond ou d’effets adaptés à la scène ; examinez le son réel et toute parole demandée avec l’image.
Le tableau actuel des modèles indique des MP4 720p ou 1080p à 30 images par seconde, avec des sorties à partir de texte ou d’images de deux à quinze secondes. Le profil de références séparé est limité à deux à dix secondes. La génération à partir de texte propose les cadrages 16:9, 9:16, 1:1, 4:3 et 3:4. Les tâches conditionnées par une image utilisent leurs propres règles de proportions sources approximatives : préparez donc le recadrage d’entrée pour la destination prévue. Une règle de durée ou de rapport du profil de références ne doit pas remplacer celle du processus d’images de début et de fin ou de prolongement.
Le processus documenté du producteur est asynchrone : un identifiant de tâche suit le traitement et un résultat réussi fournit l’adresse de la vidéo. Les résultats sont documentés avec des liens valides pendant vingt-quatre heures : conservez donc le clip lui-même et les matériaux créatifs pour la revue de montage. Les options de réécriture de prompt, de filigrane et de seed appartiennent à l’interface choisie. Le producteur indique qu’un seed fixe peut améliorer la reproductibilité sans garantir un résultat identique. Comparez le fichier renvoyé au brief au lieu de supposer que les réglages seuls préservent chaque détail.
Par rapport à Wan 2.6, le guide d’images 2.7 ajoute spécifiquement le contrôle des premières et dernières images et le prolongement vidéo par des entrées multimodales. Wan 3.0 introduit une structure tout-en-un différente et une durée de génération autorisée plus longue. Ce profil 2.7 conserve ses contrôles et ses limites propres à chaque tâche. Examinez toute la scène pour la continuité du sujet, les images imposées, l’identité des références, le dialogue, le mouvement et les raccords, et ciblez la correction suivante sur le problème réel constaté.
Ailoot Ultra · Vidéo POST /v1/videos alibaba/wan-2.7
alibaba/wan-2.7Premiers pas
Alibaba Wan 2.7 crée des vidéos avec du son à partir de texte, d’images de début et de fin ou de références visuelles. Son workflow d’image poursuit aussi un clip source en utilisant la durée totale demandée. Le fabricant annonce du MP4 en 720p ou 1080p à 30 fps : 2–15 secondes pour les modes texte/image et jusqu’à 10 secondes pour la génération à partir de références.
- Entrées acceptées
- Texte
- Résultats
- Vidéo
Disponible dans Ailoot · entrées et méthodes
Ailoot Ultra · Vidéo POST /v1/videos
- Types d’entrée
text- Types de sortie
video- Format de sortie
- mp4
- Nombre de sorties
- Jusqu’à 4 sorties
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites alibaba/wan-2.7 | Par défaut— |
Champprompt | Typestring | ExigenceObligatoire | Valeurs et limites Nombre maximal d’octets UTF-8: 10 000 Caractères autres que des espaces requis: Oui | Par défaut— |
Champduration | Typeinteger | ExigenceObligatoire | Valeurs et limites 2, 3, 4, 5, 6, 7, 8, 9, 10 | Par défaut— |
Champresolution | Typestring | ExigenceObligatoire | Valeurs et limites 720p | Par défaut— |
Champaspect_ratio | Typestring | ExigenceObligatoire | Valeurs et limites 16:9, 9:16, 1:1, 4:3, 3:4 | Par défaut— |
Champgenerate_audio | Typeboolean | ExigenceObligatoire | Valeurs et limites false, true | Par défaut— |
Combinaisons d’éléments d’entrée
Texte vers vidéo · Obligatoire : prompt
Paramètres et cycle de vie de la méthode
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, prompt, duration, resolution, aspect_ratio, generate_audio |
Paramètreadditional_properties | Contratfalse |
Paramètreparameters | Contrat{"name":"model","type":"string","required":true,"enum":["alibaba/wan-2.7"]}, {"name":"prompt","type":"string","required":true,"non_whitespace":true,"max_utf8_bytes":10000}, {"name":"duration","type":"integer","required":true,"enum":[2,3,4,5,6,7,8,9,10]}, {"name":"resolution","type":"string","required":true,"enum":["720p"]}, {"name":"aspect_ratio","type":"string","required":true,"enum":["16:9","9:16","1:1","4:3","3:4"]}, {"name":"generate_audio","type":"boolean","required":true,"enum":[false,true]} |
Paramètrematerial_types | Contrattext |
Alias de méthode : /v1/videos/generations, /videos, /videos/generations
Cycle de vie : submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Conservez la réponse complète et les identifiants d’origine renvoyés.
Ne soumettez jamais à nouveau une création dont l’issue est inconnue.
Tarifs
Calcul du coût final
Les tarifs affichés servent à estimer le coût avant la génération. Le montant final est calculé à partir du coût enregistré pour la génération d’origine. La durée mesurée du résultat et les quantités prévisionnelles ne constituent pas la quantité finale facturable.
Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.
- Mode rapide
- Non précisé Lorsque le mode rapide est sélectionné
- Mode Flex
- Non précisé Lorsque le mode flex est sélectionné
- Effort de raisonnement maximal
- Non précisé Lorsque l’effort de raisonnement maximal utilise l’ajustement par défaut (default)
Tarifs estimés à des fins de comparaison
Prix par configuration
Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.
| Configuration | Barème tarifaire | Quantité prévisionnelle | Options de génération audio | Résolution | Unité de facturation | Coût |
|---|---|---|---|---|---|---|
| ConfigurationTarifs de base par jeton | Barème tarifaireTarif de base | Quantité prévisionnelle— | Options de génération audio— | Résolution— | Unité de facturation— | Coût Entrée · Tokens en entrée · Estimation à des fins de comparaison uniquement — / 1K tokens Sortie · Tokens en sortie · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Lecture du cache · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Écriture dans le cache · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Écriture dans le cache, 1 h · Estimation à des fins de comparaison uniquement — / 1K tokens |
| ConfigurationUltra | Barème tarifaire— | Quantité prévisionnelleConfiguration demandée ; estimation uniquement. | Options de génération audioSans audio · Avec audio | Résolution720p | Unité de facturationpar seconde de vidéo en sortie | Coût Sortie · seconde estimée de vidéo · Estimation à des fins de comparaison uniquement $0.2 par seconde de vidéo en sortie Le tarif affiché estime le coût avant la génération. Le montant final est calculé à partir du coût enregistré pour la génération d’origine. La durée physique de la vidéo n’est pas la quantité facturable. |
| ConfigurationCoût de génération estimé | Barème tarifaire— | Quantité prévisionnelleEstimation pour une génération | Options de génération audio— | Résolution— | Unité de facturation— | Coût Sortie · Coût estimé de génération · Estimation à des fins de comparaison uniquement $0.4 estimation avant génération Cette estimation ne constitue ni des frais supplémentaires ni un tarif fixe pour la génération terminée. |
Ailoot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. Fonctionnement de la réservation et du débit →
Détails du tarif de référence
Les barèmes de référence du modèle ne modifient ni la sélection de méthode, ni les devis, ni les coûts. Les frais actifs utilisent les tarifs de la méthode Ailoot sélectionnée.
Références tarifaires des configurations vidéo
Prix par configuration
| Configuration | Conditions de facturation | Coût |
|---|---|---|
| ConfigurationTarif vidéo | Conditions de facturationCette clé de tarification ne déclare aucune condition supplémentaire. | Coût Sortie · Tarif vidéo $0.2 par seconde de vidéo Tarif publié de référence pour la configuration affichée. Les frais définitifs correspondent à la configuration réellement facturée. |
Exemples de requêtes
Ailoot Ultra · Vidéo
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "alibaba/wan-2.7", "prompt": "a calm greenhouse", "duration": 6, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": true}')
Path('request.json').write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Recevoir et enregistrer les résultats
Ailoot Ultra · Vidéo
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Vérifier l’état de la tâche
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Autres lectures de contenu
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
Conserver tous les résultats terminés
Enregistrez chaque vidéo terminée ou fichier renvoyé ; récupérez chaque URL de ressource effectivement renvoyée.
Une fois la tâche terminée, conservez chaque URL signée vous appartenant dans data[] ainsi que les métadonnées complètes du statut. Enregistrez chaque sortie, y compris son audio généré. Une piste audio AAC valide peut être présente même avec generate_audio=false ; conservez le MP4 d’origine complet, y compris cette piste audio.
Si la réponse d’origine doit être vérifiée
Consultez la tâche d’origine existante ; ne soumettez jamais à nouveau un envoi dont l’issue est inconnue.
Nombre maximal de sorties : 4.
Champs de la réponse
| Champ | Type | Signification |
|---|---|---|
Champid | Typestring | Signification— |
Champobject | Typestring | Signification— |
Champmodel | Typestring | Signification— |
Champstatus | Typestring | Signification— |
Champdata[] | Typesigned content URL | Signification— |
Champcharge_pending_check | Typeboolean | Signification— |
Champerror.code | Typestring | Signification— |
Champerror.message | Typestring | Signification— |
Champoperation_id | Typestring | SignificationRéponse au statut ou au contenu d’origine HTTP503 result_pending_check : même identifiant vidéo public d’origine dans id. |
Champerror.type | Typestring | Significationserver_error pour HTTP503 result_pending_check. |
Erreurs et étapes suivantes
| Réponse | Condition | Étape suivante |
|---|---|---|
Réponse400 · invalid_request_error | ConditionLa lecture du corps brut de la requête échoue avant l’analyse du profil vidéo | Étape suivanteConservez la réponse renvoyée et corrigez le corps illisible de la requête. |
Réponse422 · price_unavailable | ConditionL’analyse du profil vidéo exact échoue, ou le profil analysé complet ne dispose d’aucune fiche tarifaire exacte prête à l’emploi | Étape suivanteConservez la réponse ; utilisez le profil complet et exact autorisé ainsi que sa fiche publiée. Cette branche s’exécute avant l’envoi au fournisseur. |
Réponse409 · video_not_ready | ConditionLe contenu du résultat d’origine n’est pas encore disponible | Étape suivanteInterrogez l’identifiant d’origine renvoyé et respectez Retry-After. |
Réponseserver_error | ConditionLa réponse renvoyée indique que l’opération ou le résultat nécessite une vérification | Étape suivanteConservez l’identifiant d’opération/de tâche initialement renvoyé, les en-têtes de la requête et la réponse ; poursuivez les lectures prises en charge de cette opération d’origine. Ne soumettez pas à nouveau la requête de création. |
Réponse503 · result_pending_check | ConditionGET du statut ou du contenu d’origine : la tâche n’est pas publiée, la tâche d’origine n’est pas failed/cancelled/expired et l’état local est unknown ou le statut de la tâche d’origine est completed. | Étape suivanteConservez les valeurs d’origine id et operation_id (même identifiant vidéo public), la réponse et les en-têtes ; consultez uniquement le statut et le contenu d’origine. Ne soumettez jamais une nouvelle demande de génération. |
Alias
Alias du modèle
Ailoot Ultra alibaba/wan-2.7
Alias des chemins de méthode
/v1/videos/generations, /videos, /videos/generations
ID d’appel associés
FAQ · Alibaba: Wan 2.7
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/videos·alibaba/wan-2.7:text→video- Quels champs la requête utilise-t-elle ?
POST /v1/videos·alibaba/wan-2.7:model,prompt,duration,resolution,aspect_ratio,generate_audio