Skip to main content

​
Aperçu

Ces points de terminaison s’adressent aux équipes qui utilisent déjà la structure de tâche Seedance de style Volc. L’authentification utilise votre clé API TokenLab Bearer. L’ID de tâche retourné commence par cgt-; interrogez le statut jusqu’à ce que status devienne succeeded, failed, cancelled ou expired. Le contrat officiel des tâches utilise les chemins REST sous /api/v3/contents/generations/tasks. Les anciens alias Action restent disponibles uniquement pour les intégrations TokenLab existantes et ne font pas partie du contrat officiel compatible au niveau du protocole. callback_url accepte une adresse HTTP(S) publique. TokenLab envoie exactement l’objet de requête à chaque passage à queued, running, succeeded, failed ou expired, sans en-têtes privés TokenLab. succeeded et failed sont réessayés jusqu’à trois fois après cinq secondes.
Pour reprendre sans doublon après une déconnexion, envoyez un Idempotency-Key unique avec la création REST. Répéter le même body avec la même clé renvoie le même ID cgt-... ; la même clé avec un body différent renvoie 409. Cela ne s’applique pas à l’ancienne route Action.
Voir aussi Modèles vidéo Seedance 2.0 et Génération vidéo.

​
Règles de contenu

  • Utilisez type=text pour le texte du prompt.
  • type=image_url sans role est traité comme le premier frame; vous pouvez aussi définir role=first_frame.
  • Utilisez role=last_frame uniquement avec un premier frame.
  • Utilisez role=reference_image, reference_video ou reference_audio pour les médias de référence.
  • Ne mélangez pas les entrées premier/dernier frame avec des médias de référence dans une même requête.

​
Notes sur les paramètres

  • ratio accepte 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 ou adaptive.
  • La valeur officielle par défaut de generate_audio est false; utilisez true lorsqu’un son synchronisé est requis.
  • service_tier=default est accepté. Les tâches compatibles Seedance 2.0 rejettent service_tier=flex, frames et camera_fixed=true.
  • Quand le modèle sélectionné le prend en charge, tools peut contenir des objets comme { "type": "web_search" }. Les entrées tool mal formées sont rejetées au lieu d’être ignorées.

​
Exemple