API Génération vidéo

La génération vidéo est une tâche asynchrone : POST /videos/generations retourne immédiatement un ID de tâche, puis sondez GET /videos/generations/{id} jusqu'à ce que status devienne completed, et lisez video_url pour télécharger le résultat.

Modèles pris en charge : seedance-1.5-pro, seedance-2.0, etc. Utilisez GET /videos/models pour la liste à jour. Schéma complet et contraintes dans l'explorateur d'API interactif.

• GET https://api.alltoken.ai/v1/videos/models — lister les modèles vidéo disponibles
• POST https://api.alltoken.ai/v1/videos/generations — créer une tâche de génération
• GET https://api.alltoken.ai/v1/videos/generations/{id} — sonder l'état de la tâche
• GET https://api.alltoken.ai/v1/videos/generations — lister les tâches
• POST https://api.alltoken.ai/v1/videos/generations/{id}/cancel — annuler une tâche

Retourne tous les modèles de génération vidéo disponibles au format compatible OpenAI.

Texte→vidéo :

Image→vidéo (guidage par première image) :

Réponse (tâche créée, statut queued) :

• model (requis) — ID du modèle vidéo (ex. "seedance-1.5-pro")
• prompt (requis) — Description textuelle de la vidéo souhaitée
• content — Tableau d'entrée multimodale (image→vidéo, référence vidéo). Chaque élément contient type (image_url / video_url / audio_url / draft_task) et role (first_frame / last_frame / reference_image / reference_video / reference_audio)
• ratio — Rapport d'image : 16:9 / 9:16 / 4:3 / 3:4 / 21:9 / 1:1 / adaptive
• duration — Durée en secondes ; -1 pour décision automatique
• resolution — 480p / 720p / 1080p
• frames — Nombre d'images (priorité sur duration)
• generate_audio — Générer une piste audio synchronisée
• input_has_video - Set when the input content includes a video reference
• seed — Graine aléatoire pour la reproductibilité
• camera_fixed — Verrouiller la caméra
• watermark — Ajouter un filigrane (par défaut false)
• callback_url — URL appelée à la fin de la tâche
• return_last_frame — Retourner l'URL de la dernière image (pour continuation)
• service_tier — default / flex
• execution_expires_after — Fenêtre d'expiration de l'exécution en secondes (3600-259200)
• draft — Créer ou utiliser une tâche brouillon lorsque le modèle le prend en charge
• tools — Configuration d'outils optionnelle, par exemple web_search
• safety_identifier — Identifiant de sécurité stable optionnel, jusqu'à 64 caractères

Retourne les détails de la tâche. Quand status est completed, video_url est l'URL de téléchargement.

video_url est une URL pré-signée qui expire après video_url_ttl secondes. Rappelez ce point de terminaison après expiration pour obtenir une nouvelle URL.

• queued — En file d'attente, en attente de GPU
• processing — Modèle en cours de génération
• completed — Terminée, video_url disponible
• failed — Échec de génération ; détails dans error
• expired — video_url expirée et non rafraîchie
• cancelled — Annulée par l'utilisateur

Intervalle de sondage recommandé : 2-5 secondes. La plupart des tâches se terminent en 30-120 s ; les rendus haute résolution peuvent prendre 3-5 minutes.

Liste paginée des tâches de génération vidéo de l'utilisateur courant. Paramètres de requête :

• limit — Taille de page (par défaut 20, max 100)
• status — Filtrer par statut (queued / processing / completed / failed / expired / cancelled)

Annule une tâche non encore terminée (queued ou processing uniquement). Les tâches déjà completed / cancelled retournent 409 Conflict.

• 400 — Mauvaise requête (ex. prompt vide, ratio invalide)
• 401 — API Key invalide ou manquante
• 402 — Solde insuffisant
• 404 — ID de tâche introuvable
• 409 — État de la tâche n'autorise pas cette action (ex. annuler une tâche terminée)
• 429 — Limite de débit dépassée