Alibaba: Wan 3.0 Prime
Alibaba Wan 3.0 Prime est le modèle vidéo Wan 3.0 optimisé pour la vitesse. Son profil producteur prend en charge la génération à partir de texte, d’une première image ou d’images de début et de fin, ainsi que les références multimodales, avec du son intégré. Il produit des clips MP4 de 2 à 30 secondes à 30 images par seconde en 480p, 720p ou 1080p, avec cadrage adaptatif et fonctions de modification.
À 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 3.0 Prime est l’édition accélérée de la famille vidéo Wan 3.0. Le producteur la nomme wan3.0-video-prime et documente les mêmes catégories de tâches tout-en-un que Wan 3.0 standard, la vitesse constituant la particularité mise en avant de cette édition. Un brief écrit, une image de départ, des références visuelles ou sonores, ou une vidéo source peuvent guider un clip avec son audio. Les livrables utiles comprennent une scène de produit, une courte séquence narrative, une image fixe animée ou une révision dirigée d’un plan existant.
Pour la génération de vidéo à partir de texte, décrivez le sujet, la scène, le mouvement, la caméra, le traitement visuel et le son. Le guide 3.0 prend en charge les plans uniques ou un storyboard avec des étiquettes de plans et des plages temporelles, en recommandant environ quatre à six secondes par plan. Pour un clip de produit, passez d’une vue large stable d’un sac sur une table à un détail de matière plus rapproché, puis maintenez une composition finale pendant une courte réplique. Donnez un objectif clair à la séquence et vérifiez que la caméra, le rythme et l’identité du produit restent cohérents.
Pour la génération à partir d’une première image, l’image fournie définit l’ouverture et le prompt décrit le mouvement et le travail de caméra. La génération avec première et dernière image fournit les deux extrémités et demande la transition entre elles. Préparez des extrémités qui appartiennent à la même scène et un format cible cohérent avec la sortie prévue. Le producteur recommande le cadrage adaptatif pour les tâches basées sur des images. Le mode d’images de début et de fin et les modes de références distincts ont des règles différentes de combinaison des matériaux : les premières ou dernières images ne sont pas mélangées avec des entrées d’images, de vidéos ou de sons de référence dans une même requête.
Le mode de références accepte jusqu’à dix images, cinq clips vidéo et cinq clips audio, dans une limite de vingt matériaux de référence multimodaux. Les limites documentées par fichier sont de 20 Mo pour une image de référence, 100 Mo pour une vidéo et 15 Mo pour le son. Les clips vidéo de référence peuvent totaliser au maximum quinze secondes ; les clips audio de référence ont leur propre limite totale de quinze secondes. Nommez le rôle de chaque matériau et utilisez son indice propre au type, par exemple Image 1, Video 1 ou Audio 1. Une personne, un produit, un mouvement de caméra et une voix ne doivent pas rester des références interchangeables.
Le producteur prend aussi en charge un document ou une référence de page web publique, qui peuvent accompagner d’autres références. Un fichier et un lien web s’excluent mutuellement, et la source doit être accessible sans connexion. Une scène basée sur un document peut utiliser le contenu pertinent d’un produit ou d’une histoire comme contexte, tandis qu’une référence visuelle définit l’apparence. Préparez les matériaux qui doivent réellement informer le clip et précisez les éléments importants. Vérifiez les détails visuels factuels et le texte de la scène générée par rapport à cette source, au lieu d’accepter une interprétation séduisante mais altérée.
Le dialogue vocal, l’ambiance, les effets sonores et la musique de fond sont générés avec l’image. Décrivez les mots prononcés, l’identité de la personne qui parle, l’interprétation et la place du son dans la scène. Le guide documente le son activé par défaut et un contrôle de vidéo muette. Dans un dialogue, donnez aux personnes qui parlent des signes visuels et vocaux distinctifs et laissez assez de temps à l’échange. Écoutez le résultat pour les mots réellement prononcés, l’attribution des voix et la relation entre un effet et l’action visible. Le son intégré fait partie de la scène et nécessite donc la même revue que l’image.
Le guide tout-en-un du producteur documente aussi la modification et le prolongement à partir d’une vidéo de référence. Un brief de modification doit préciser l’élément à ajouter, supprimer ou remplacer et les caractéristiques à conserver. Un brief de prolongement doit décrire le contenu avant, après ou autour du clip existant. Utilisez le cadrage adaptatif et la durée intelligente pour ces fonctions. Lorsqu’une entrée vidéo est fournie, la durée combinée documentée de la vidéo d’entrée et de celle de sortie ne doit pas dépasser 30 secondes. Préparez clairement le passage source et le changement souhaité ; vérifiez la transition, le sujet conservé et le son au lieu de juger une seule image attrayante.
La sortie documentée est un MP4 à 30 images par seconde, en 480p, 720p ou 1080p, avec une durée de nouvelle génération de deux à trente secondes. La durée intelligente laisse le modèle choisir une longueur adaptée. Des cadrages carrés, paysage et portrait sont disponibles, et le cadrage adaptatif suit les matériaux fournis. Le producteur traite la génération comme une tâche et renvoie l’adresse de la vidéo terminée ; son guide indique que cette adresse de résultat est valide pendant vingt-quatre heures. Conservez le clip lui-même et le brief créatif lorsque vous préparez un montage ou une séquence et examinez le livrable entier avant de l’utiliser.
Prime et Wan 3.0 standard partagent les modes et la structure de préparation documentés. Prime est le choix optimisé pour la vitesse, sans garantie de délai fixe d’achèvement. Les modes antérieurs de Wan 2.7 et 2.6 ont leurs propres règles de durée, de références et de sortie ; ces limites ne définissent pas cette édition 3.0. Pour une revue utile, vérifiez la continuité des objets et des personnages, le cadrage des images de début et de fin, les modifications demandées, le dialogue et tous les détails dépendants des sources. Gardez la correction suivante précise afin que les éléments réussis de la scène restent stables pendant la révision du problème identifié.
Ailoot Ultra · Vidéo POST /v1/videos alibaba/wan-3.0-prime
alibaba/wan-3.0-primePremiers pas
Alibaba Wan 3.0 Prime est le modèle vidéo Wan 3.0 optimisé pour la vitesse. Son profil producteur prend en charge la génération à partir de texte, d’une première image ou d’images de début et de fin, ainsi que les références multimodales, avec du son intégré. Il produit des clips MP4 de 2 à 30 secondes à 30 images par seconde en 480p, 720p ou 1080p, avec cadrage adaptatif et fonctions de modification.
- Entrées acceptées
- Texte · Images
- Résultats
- Vidéo
Disponible dans Ailoot · entrées et méthodes
Ailoot Ultra · Vidéo POST /v1/videos
- Entrée
text,image- Sortie
video- Format de sortie
- Octets MP4 d’origine ; sans normalisation ni transcodage
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites alibaba/wan-3.0-prime | Par défaut— |
Champprompt | Typestring | ExigenceObligatoire | Valeurs et limites | Par défaut— |
Champduration | Typeinteger | ExigenceObligatoire | Valeurs et limites 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 Minimum: 1 Maximum: 600 | Par défaut— |
Champresolution | Typestring | ExigenceFacultatif | Valeurs et limites 480p, 720p, 1080p | Par défaut— |
Champaspect_ratio | Typestring | ExigenceFacultatif | Valeurs et limites 16:9, 4:3, 1:1, 3:4, 9:16 | Par défaut— |
Champgenerate_audio | Typeboolean | ExigenceFacultatif | Valeurs et limites false, true | Par défaut— |
Champframe_images | Typearray | ExigenceFacultatif | Valeurs et limites Nombre minimal d’éléments: 1 Nombre maximal d’éléments: 1 Contenu en entrée: Tableau d’objets représentant les images de la séquence. Chaque objet comporte type=image_url, image_url contenant url et frame_type. Utilisez une URL d’image HTTPS et définissez frame_type sur first_frame. Chaque rôle d’image apparaît au plus une fois. Clés exactes: type, image_url, frame_type Conditions: Ces clés décrivent chaque objet représentant une image de la séquence ; image_url contient uniquement url. Omettez frame_images pour une requête contenant uniquement du texte. | Par défaut— |
Champinput_references | Typearray | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Champseed | Typeinteger | ExigenceFacultatif | Valeurs et limites Minimum: -9 223 372 036 854 775 808 Maximum: 9 223 372 036 854 775 807 | Par défaut— |
Champcallback_url | Typestring | ExigenceFacultatif | Valeurs et limites Motif: ^https:// | Par défaut— |
Champsession_id | Typestring | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Champtrace | Typeobject | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Champuser | Typestring | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Combinaisons d’éléments d’entrée
Texte vers vidéo · Une consigne écrite. · Obligatoire : model, prompt, duration
Fournissez prompt sous forme de texte et duration en secondes entières. Choisissez une résolution prise en charge et, si nécessaire, un rapport largeur/hauteur.
model: Type : string · alibaba/wan-3.0-prime
prompt: Type : string · Nombre maximal d’octets UTF-8: 10 000 · Caractères autres que des espaces requis: Oui
Image vers vidéo · Une consigne écrite et une image de début de séquence. · Obligatoire : model, prompt, duration, frame_images
frame_images est un tableau. Chaque objet représentant une image de la séquence comporte type, image_url et frame_type ; image_url contient url. Définissez type sur image_url. Utilisez first_frame. Chaque rôle d’image apparaît au plus une fois. Fournissez une URL d’image HTTPS publique pour chaque image de la séquence. Choisissez une résolution prise en charge et, si nécessaire, un rapport largeur/hauteur.
Clés exactes : type, image_url, frame_type
model: Type : string · alibaba/wan-3.0-prime
prompt: Type : string · Nombre maximal d’octets UTF-8: 10 000 · Caractères autres que des espaces requis: Oui
Paramètres et cycle de vie de la méthode
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, prompt, duration |
Paramètrematerial_types | Contrattext, image |
Paramètreadditional_properties | Contratfalse |
Paramètreoptional_controls | Contratresolution, aspect_ratio, generate_audio, frame_images, input_references, seed, callback_url, session_id, trace, user |
Cycle de vie : submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
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 | Unité de facturation | Conditions de facturation | Coût |
|---|---|---|---|---|---|
| ConfigurationTarifs de base des jetons | Barème tarifaireTarif de base | Quantité prévisionnelle— | Unité de facturation— | Conditions 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 |
| ConfigurationTarif vidéo | Barème tarifaire— | Quantité prévisionnelle— | Unité de facturationpar seconde de vidéo | Conditions de facturationresolution: 1080p | Coût Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement $0.56 par seconde de vidéo |
| ConfigurationTarif vidéo | Barème tarifaire— | Quantité prévisionnelle— | Unité de facturationpar seconde de vidéo | Conditions de facturationresolution: 480p | Coût Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement $0.136 par seconde de vidéo |
| ConfigurationTarif vidéo | Barème tarifaire— | Quantité prévisionnelle— | Unité de facturationpar seconde de vidéo | Conditions de facturationresolution: 720p | Coût Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement $0.28 par seconde de vidéo |
| ConfigurationCoût estimé de la génération | Barème tarifaire— | Quantité prévisionnelleEstimation pour une génération | Unité de facturation— | Conditions de facturation— | Coût Sortie · Coût estimé de génération · Estimation à des fins de comparaison uniquement $0.272 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
Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.
| Configuration | Conditions de facturation | Coût |
|---|---|---|
| ConfigurationTarif vidéo | Conditions de facturationresolution: 480p | Coût Sortie · Tarif vidéo $0.136 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. |
| ConfigurationTarif vidéo | Conditions de facturationresolution: 720p | Coût Sortie · Tarif vidéo $0.28 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. |
| ConfigurationTarif vidéo | Conditions de facturationresolution: 1080p | Coût Sortie · Tarif vidéo $0.56 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'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"alibaba/wan-3.0-prime","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')
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
URL de contenu signées dont vous êtes propriétaire
GET /v1/videos/{public_id}GET /v1/videos/{public_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.
Conservez chaque résultat réel dont vous êtes propriétaire ainsi que les métadonnées mesurées renvoyées avec celui-ci.
Si la réponse d’origine doit être vérifiée
503 result_pending_check + originalid + X-Should-Retry:false ; ne rejouez jamais la requête d’origine
Champs de la réponse
| Champ | Type | Signification |
|---|---|---|
Champindex | Typeinteger | SignificationPosition de cette vidéo dans la liste des résultats, avec une numérotation commençant à zéro. |
Champcontent_url | Typestring | SignificationURL de téléchargement HTTPS signée pour cette vidéo terminée. |
Champsha256 | Typestring | null | SignificationEmpreinte SHA-256 des octets vidéo d’origine ; null si elle est indisponible. |
Champsize_bytes | Typeinteger | null | SignificationTaille du fichier vidéo d’origine en octets ; null si elle est indisponible. |
Champduration_ms | Typeinteger | null | SignificationDurée mesurée de la vidéo en millisecondes ; null si elle est indisponible. |
Champwidth | Typeinteger | null | SignificationLargeur de la vidéo en pixels ; null si elle est indisponible. |
Champheight | Typeinteger | null | SignificationHauteur de la vidéo en pixels ; null si elle est indisponible. |
Champvideo_codec | Typestring | null | SignificationIdentifiant du codec vidéo ; null s’il n’a pas été enregistré. |
Champhas_audio | Typeboolean | null | SignificationIndique si la vidéo contient une piste audio ; null si cela n’a pas été mesuré. |
Champaudio_codec | Typestring | null | SignificationIdentifiant du codec audio ; null lorsqu’aucun identifiant n’a été enregistré. |
Erreurs et étapes suivantes
| Réponse | Condition | Étape suivante |
|---|---|---|
Réponse404 · not_found_error | ConditionL’accès à la vidéo est indisponible, ou cet ID vidéo est introuvable. | Étape suivanteVérifiez l’accès à la vidéo. Pour une vidéo existante, utilisez son ID public d’origine et la même clé API. |
Réponse401 · authentication_error | ConditionLa clé API ne correspond pas au compte authentifié. | Étape suivanteVérifiez votre clé API et l’accès au compte avant de soumettre la requête. |
Réponse400 · invalid_request_error | ConditionLa requête n’a pas pu être lue, ou l’index de téléchargement est invalide. | Étape suivanteCorrigez le corps de la requête. Pour un téléchargement, choisissez un index de sortie renvoyé par la tâche d’origine. |
Réponse422 · price_unavailable | ConditionLa configuration vidéo sélectionnée ne peut pas être tarifée. | Étape suivanteChoisissez une configuration vidéo prise en charge et renseignez ses options obligatoires avant de soumettre une requête corrigée. |
Réponse422 · invalid_request_error | ConditionUne entrée vidéo ou la tâche de continuation d’origine est invalide. | Étape suivanteUtilisez des entrées HTTPS valides. Pour une continuation, utilisez l’ID vidéo public de votre résultat d’origine terminé avec la même clé API. |
Réponse402 · billing_error | ConditionLe solde disponible ou les limites ne permettent pas de réserver le montant nécessaire. | Étape suivanteVérifiez votre solde disponible et vos limites avant d’envoyer une nouvelle requête. |
Réponse503 · server_error | ConditionLa vérification vidéo, le stockage ou l’accès au service est temporairement indisponible. | Étape suivanteAttendez que le service soit disponible. Si vous disposez déjà d’un ID vidéo, vérifiez cette tâche d’origine au lieu de créer une autre génération. |
Réponse503 · result_pending_check | ConditionLe résultat vidéo d’origine et sa facturation doivent être vérifiés. | Étape suivanteConservez l’ID vidéo renvoyé et vérifiez cette tâche. N’envoyez pas de requête de génération de remplacement pendant sa vérification. |
Réponse503 · owned_result_unavailable | ConditionLe téléchargement de la vidéo existante est temporairement indisponible. | Étape suivanteVérifiez la même tâche vidéo plus tard et téléchargez son résultat existant. Une nouvelle génération crée une opération distincte. |
Réponse409 · video_not_ready | ConditionLe contenu vidéo n’a pas été publié. | Étape suivanteVérifiez l’état de la tâche d’origine. Téléchargez lorsqu’il indique completed ; s’il indique failed, suivez son avis de vérification de facturation. |
Alias
Alias du modèle
Ailoot Ultra alibaba/wan-3.0-prime
Alias des chemins de méthode
Utilisez les chemins de méthode indiqués ci-dessus.
ID d’appel associés
FAQ · Alibaba: Wan 3.0 Prime
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/videos·alibaba/wan-3.0-prime:text,image→video- Quels champs la requête utilise-t-elle ?
POST /v1/videos·alibaba/wan-3.0-prime:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,seed,callback_url,session_id,trace,user- Quelles limites s’appliquent ?
POST /v1/videos·alibaba/wan-3.0-prime:duration.minimum:1;duration.maximum:600;frame_images.max_items:1;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807