Guide d’intégration Wan API

Se connecter à Wan APICopier le lien du titre

Utilisez https://api.wanapi.app comme URL de base de l’API. Créez une clé dans les paramètres des clés API, 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 en vigueur. Chaque modèle possède son propre point d’accès et sa page de présentation.

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.

Champs de la requêteCopier le lien du titre

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.

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éoCopier le lien du titre

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.

{
  "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.

{
  "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-planCopier le lien du titre

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.

{
  "model": "wan3.0-video",
  "input": "A blue ball rolls across a white table.",
  "resolution": "480p",
  "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 erreursCopier le lien du titre

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 si un envoi au résultat incertain nécessite une vérification.