# Wan 3.0 Prime Pro (https://wanapi.app/fr/docs/wan-3-0-prime-pro) Wan 3.0 Prime Pro possède son propre identifiant de modèle et ses propres tarifs, avec une sortie en 1080p, 2K et 4K. Il accepte le texte, les images et les médias de référence. Son point d’accès est distinct de celui de Prime ; demander du 4K sur le point d’accès Prime ne sélectionne pas Prime Pro. [Détails du modèle et Playground](/fr/models/wan-3-0-prime-pro). ## Se connecter à Wan API [#se-connecter-à-wan-api] Utilisez `https://api.wanapi.app` comme URL de base de l’API. Créez une clé dans les [paramètres des clés API](/fr/settings/apikeys), puis transmettez-la avec `Authorization: Bearer YOUR_API_KEY`. Conservez vos clés sur votre serveur. Le Playground utilise votre session sur le site et débite le même solde de compte ; vous n’avez pas à coller une clé dans le navigateur. L’accès nécessite un compte actif doté d’un solde suffisant. Consultez les [tarifs](/fr/pricing) en vigueur. Chaque modèle possède son propre point d’accès et sa [page de présentation](/fr/models). `GET /v1/models` répertorie les modèles accessibles avec votre clé. Choisir une résolution supérieure ne change pas automatiquement de modèle. | Paramètre | Wan 3.0 Prime Pro | | --------------------- | ------------------------------------------------------------------------------------------- | | Identifiant du modèle | `w3.0-video-prime-pro` | | `resolution` | `1080p`, `2k`, `4k` ; valeur par défaut : `1080p`. | | `duration` | De 2 à 30 secondes de sortie, ou `-1` pour une durée automatique ; valeur par défaut : `5`. | | `ratio` | `adaptive`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16` ; valeur par défaut : `adaptive`. | | `audio` | `true` par défaut. `false` ne réduit pas le tarif. | Les [champs communs de la requête](#champs-de-la-requête) décrivent les 14 champs natifs, les limites des médias et les combinaisons d’entrées. Ce modèle utilise `w3.0-video-prime-pro` dans l’URL des requêtes natives et comme valeur de `model` dans les [requêtes Responses](#api-responses-synchrone-et-en-arrière-plan). ## Lancer une tâche Wan 3.0 Prime Pro [#lancer-une-tâche-wan-30-prime-pro] Cette requête génère une vidéo de deux secondes à partir de texte, à la résolution la plus basse de ce modèle. Définissez `WAN_API_KEY` avec votre clé sur le serveur. Le modèle est sélectionné dans l’URL ; n’ajoutez pas de champ `model` à ce corps JSON natif. ```bash curl https://api.wanapi.app/wan/v1/w3.0-video-prime-pro/generation \ -H "Authorization: Bearer $WAN_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "prompt": "A camera glides past sunlit coastal cliffs above a calm sea.", "duration": 2, "resolution": "1080p", "ratio": "16:9", "audio": false, "prompt_extend": false }' ``` ## Consulter une tâche Wan 3.0 Prime Pro [#consulter-une-tâche-wan-30-prime-pro] Enregistrez le `task_info.id` reçu dans `TASK_ID`, puis interrogez le même point d’accès du modèle. La réponse à l’envoi confirme la création de la tâche ; elle ne contient pas encore la vidéo terminée. Commencez par une interrogation toutes les cinq secondes ; consultez les [statuts des tâches et le téléchargement](#suivre-la-tâche-et-télécharger-la-vidéo). ```bash curl "https://api.wanapi.app/wan/v1/w3.0-video-prime-pro/generation/$TASK_ID" \ -H "Authorization: Bearer $WAN_API_KEY" ``` ## Tarifs de Wan 3.0 Prime Pro [#tarifs-de-wan-30-prime-pro] Le tableau présente les tarifs actuels en USD par seconde facturable. Les secondes des vidéos de référence en entrée et de la vidéo générée sont toutes comptabilisées. L’exemple de cinq secondes ne comprend aucune vidéo de référence. Consultez la section [facturation et gestion des erreurs](#facturation-et-gestion-des-erreurs) pour la réservation du montant et le calcul du coût final. [Consulter les tarifs de Wan 3.0 Prime Pro](/fr/models/wan-3-0-prime-pro#pricing). ## Champs de la requête [#champs-de-la-requête] Les quatre modèles partagent ces 14 champs natifs. Fournissez un prompt ou au moins un média en entrée. Les images de début et de fin ne peuvent pas être combinées avec des entrées de référence, `file` ou `link` ; `file` et `link` sont mutuellement exclusifs. | Champ | Type | Règles | | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------- | | `prompt` | string | Jusqu’à 20 000 caractères. | | `first_frame` | string | URL HTTP(S) d’une image, URI de données d’image ou Base64. | | `last_frame` | string | URL HTTP(S) d’une image, URI de données d’image ou Base64. | | `reference_images` | string\[] | Jusqu’à 10 images, dans les mêmes formats que les images de début et de fin. | | `reference_videos` | string\[] | Jusqu’à 5 URL publiques MP4/MOV ; de 1 à 15 secondes par clip, avec un maximum de 15 secondes de référence au total. | | `reference_audios` | string\[] | Jusqu’à 5 URL HTTP(S) de fichiers audio. | | `file` | string | URL publique d’un document. | | `link` | string | URL publique d’une page web. | | `resolution` | string | Voir le tableau des modèles. Valeur par défaut : `1080p`. | | `ratio` | string | `adaptive`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`. Valeur par défaut : `adaptive`. | | `duration` | integer | De 2 à 30 secondes de sortie, ou `-1` pour une durée automatique. Valeur par défaut : `5`. | | `audio` | boolean | Générer du son. Valeur par défaut : `true`. Désactiver cette option ne réduit pas le tarif. | | `seed` | integer | 0–2147483647. Omettez ce champ pour une génération aléatoire. | | `prompt_extend` | boolean | Enrichir le prompt. Valeur par défaut : `true`. | Utilisez des URL de médias stables, directement accessibles et disponibles jusqu’à la fin de la tâche. La vérification de la durée des vidéos repose sur des lectures partielles HTTP à taille limitée ; les serveurs vidéo doivent les prendre en charge et fournir des métadonnées de durée MP4/MOV lisibles. Ces vérifications ne suivent pas les redirections. Les URL de réseaux privés ne sont pas prises en charge. La durée cumulée des vidéos de référence et de la sortie ne doit pas dépasser 30 secondes. Le Playground accepte un corps de requête JSON jusqu’à 32 MiB ; utilisez des URL pour les entrées plus volumineuses. ## Suivre la tâche et télécharger la vidéo [#suivre-la-tâche-et-télécharger-la-vidéo] Le point d’accès de génération de chaque modèle renvoie un identifiant de tâche public. Enregistrez-le avant toute autre opération. ```json { "task_info": { "id": "task_EXAMPLE", "status": "pending" } } ``` Utilisez l’exemple de consultation du chapitre correspondant au modèle. Commencez par un intervalle de cinq secondes, puis augmentez ce délai en cas d’erreurs temporaires. Conservez l’identifiant du modèle avec celui de chaque tâche ; ne consultez pas cette tâche via le point d’accès d’un autre modèle. Les statuts natifs sont `pending`, `processing`, `completed` et `failed`. Une réponse terminée contient `videos`, un tableau avec une URL Bunny CDN signée complète. ```json { "task_info": { "id": "task_EXAMPLE", "status": "completed" }, "videos": ["https://reapiflexible.b-cdn.net/flexible/v1/expires/2026-11/20261113T06/wanapi-task_EXAMPLE/video.mp4?token=HS256_SIGNATURE&expires=1794550071"] } ``` Utilisez directement l’URL renvoyée pour lire ou télécharger la vidéo ; cette URL ne nécessite ni clé API ni en-tête Authorization. Les fichiers suivent la politique de conservation existante du stockage. Consulter une tâche ne génère pas de nouvelle vidéo, n’entraîne pas de frais supplémentaires et ne prolonge pas la disponibilité du fichier. Sauvegardez les fichiers à conserver dans votre propre stockage. La consultation des tâches exige votre clé API et ne renvoie que les tâches de votre compte. ## API Responses synchrone et en arrière-plan [#api-responses-synchrone-et-en-arrière-plan] Pour les clients utilisant l’API Responses, `POST /v1/responses` accepte un identifiant de modèle, un champ `input` de type chaîne et les mêmes champs natifs de génération. Utilisez `input` à la place de `prompt`. Les champs de médias natifs tels que `reference_images` restent au premier niveau du JSON. ```json { "model": "w3.0-video-prime-pro", "input": "A blue ball rolls across a white table.", "resolution": "1080p", "duration": 2, "background": true } ``` Avec `background: true`, conservez l’identifiant de réponse, puis interrogez `GET /v1/responses/{response_id}`. Sans `background`, la requête HTTP attend la fin de la génération. `stream: true` utilise des événements envoyés par le serveur (SSE) pendant l’attente. La sortie finale de l’assistant contient une URL vidéo signée ; ce lien donne accès à la vidéo et doit rester privé. Ne le publiez pas par inadvertance. L’envoi de tâches natives et les requêtes Responses en arrière-plan sont recommandés pour les générations longues et les proxys aux délais d’attente courts. La déconnexion ou l’expiration d’une requête synchrone n’annule pas la génération. La tâche reste sur le serveur. Ne soumettez pas automatiquement la même génération une seconde fois. ## Facturation et gestion des erreurs [#facturation-et-gestion-des-erreurs] Le prix correspond au tarif du modèle pour la résolution choisie, multiplié par les secondes facturables. Les secondes des vidéos de référence et de la sortie sont comptabilisées ; les entrées texte, image et audio n’ajoutent aucune seconde vidéo. Les requêtes à durée fixe sans vidéo de référence réservent le montant correspondant à la durée de sortie demandée. Les requêtes à durée automatique ou avec des vidéos de référence réservent jusqu’à 30 secondes facturables, puis le montant est ajusté à l’utilisation mesurée et la part inutilisée est restituée. En cas d’échec de génération, le montant réservé est libéré. Interroger le statut ne crée pas de nouvelle génération et n’entraîne pas de nouvelle facturation. * **Paramètres invalides :** corrigez la requête avant de la soumettre à nouveau. Les champs natifs inconnus sont rejetés. * **Solde insuffisant :** approvisionnez le compte avant toute nouvelle requête payante. La limite d’une clé n’ajoute pas de crédit au compte. * **Limite de requêtes ou échec temporaire du suivi :** réessayez uniquement la consultation du statut, avec un délai croissant et une durée d’attente maximale. * **Délai d’envoi dépassé, interruption réseau ou identifiant de tâche manquant :** le résultat de l’envoi peut être inconnu. Ne répétez pas automatiquement le POST, car cela pourrait créer une seconde tâche payante. * **Échec de tâche :** distinguez l’état d’échec d’une consultation du statut temporairement indisponible. * **Échec de téléchargement :** réessayez de télécharger la tâche terminée existante avant de lancer une autre génération. Les requêtes de génération ne sont ni renvoyées automatiquement ni basculées vers un autre modèle. Aucun mécanisme d’annulation, de webhook ou de clé d’idempotence n’est garanti. Conservez l’identifiant de tâche et contactez le [support](/fr/contact) si un envoi au résultat incertain nécessite une vérification.