GetRouterDocs
  • Français

    • Vidéo

    La génération vidéo est asynchrone. Créez une tâche, conservez son ID, interrogez son statut et téléchargez le résultat une fois la tâche terminée.

    Les endpoints vidéo généraux sont :

    POST /v1/videos
GET  /v1/videos/{task_id}
GET  /v1/videos/{task_id}/content

    Créer une tâche vidéo

    L’endpoint /v1/videos accepte des données de formulaire multipart :

    curl https://getrouter.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=MODEL_ID" \
  -F "prompt=A paper airplane flying through a quiet modern office" \
  -F "seconds=8"

    Pour une génération de vidéo à partir d’une image, ajoutez un fichier de référence lorsque le modèle le prend en charge :

    curl https://getrouter.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=MODEL_ID" \
  -F "prompt=Add a slow camera push and subtle movement" \
  -F "seconds=8" \
  -F "[email protected]"

    Une réponse réussie comprend un identifiant de tâche tel que id, ainsi que, lorsqu’elles sont disponibles, des métadonnées telles que le statut, la progression, le modèle, la durée ou les horodatages.

    Vérifier le statut de la tâche

    curl https://getrouter.ai/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

    Interrogez le statut à un intervalle raisonnable. Arrêtez les interrogations lorsque la tâche atteint un état terminal de réussite ou d’échec.

    Télécharger le résultat

    Une fois la tâche terminée :

    curl -L https://getrouter.ai/v1/videos/TASK_ID/content \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --output result.mp4

    Flux de travail de tâche recommandé

    1. Validez le modèle, la durée et l’entrée avant l’envoi.
    2. Envoyez la tâche une seule fois.
    3. Conservez durablement l’ID de tâche renvoyé.
    4. Interrogez le statut avec un backoff plutôt que d’envoyer rapidement des requêtes répétées.
    5. Enregistrez les erreurs terminales pour faciliter la résolution des problèmes.
    6. Téléchargez rapidement le contenu terminé.
    Warning

    Ne créez pas automatiquement une tâche de remplacement lorsqu’une requête de statut expire. Interrogez d’abord l’ID de la tâche d’origine pour éviter les générations et les frais en double.

    API vidéo propres aux fournisseurs

    La spécification de l’API comprend également des chemins vidéo compatibles avec certains fournisseurs, notamment des formats de type Kling et d’autres formats de tâches. Les champs de requête et les réponses de statut diffèrent selon ces endpoints. Pour les nouvelles intégrations, utilisez le flux général /v1/videos, sauf si un modèle ou un client existant nécessite un chemin propre à un fournisseur.

    Consultez la référence de l’API pour connaître les chemins et schémas actuellement exposés.

    Contrôle des coûts

    Le coût d’une vidéo peut dépendre du modèle, de la durée, de la résolution, de la qualité ou du type d’entrée. Consultez les tarifs et commencez par de courtes tâches de test avant de lancer des lots automatisés.

    Étapes suivantes