Créer une vidéo

ID du modele video. Utilisez les IDs de modèle affichés par TokenLab comme veo3.1, wan-2.7, happyhorse-1.0, viduq3, pixverse-v6 ou kling-3.0-video; choisissez text-to-video, image-to-video, reference-to-video ou d autres variantes avec operation. Voir le guide video et Models API.

Description textuelle de la vidéo à générer. Ce champ est requis pour la plupart des modèles publics.

Opération vidéo à exécuter. Les valeurs acceptées sont text-to-video, image-to-video, reference-to-video, start-end-to-video, video-to-video, video-extension, audio-to-video et motion-control. TokenLab peut déduire l’opération à partir des entrées, mais une valeur explicite est recommandée en production.

URL de l’image de départ pour les flux image-vers-vidéo. Pour la compatibilité la plus large, privilégiez image_url.

Image inline au format data: (par exemple data:image/jpeg;base64,...). Les modèles compatibles la prennent en charge, mais image_url reste l’option la plus robuste.

Images de référence pour les flux avec conditionnement dédié. Le nombre autorisé dépend du modèle. Pour seedance-2.0 et seedance-2.0-fast, TokenLab prend actuellement en charge jusqu'à 9 images de référence, ainsi que jusqu'à 3 vidéos de référence et 3 audios de référence. Pour le choix du modèle, les limites 4K et les notes Mini, consultez le guide des modèles vidéo Seedance 2.0. Les URL publiques https sont recommandées ; les modèles compatibles acceptent aussi les URL data:. Pour grok-imagine-video, reference-to-video accepte jusqu’à 7 références image et duration est limitée à 10 secondes. grok-imagine-video-1.5-preview est limité à image-to-video et n’accepte pas les références image.

ID de matériau Seedance TokenLab renvoyé par Créer un matériau. Utilisez-le après le statut ACTIVE avec les modèles Seedance qui peuvent utiliser la bibliothèque de matériaux TokenLab.

Plusieurs ID de matériaux Seedance TokenLab. Ils partagent la limite de références image Seedance avec reference_images; le modèle sélectionné doit pouvoir utiliser la bibliothèque de matériaux TokenLab.

Champ facultatif pour les modèles qui distinguent les références asset et style.

Utilisez kling_elements uniquement si les détails publics actuels du modèle mentionnent ce champ. Fournissez des images et 1 à 3 éléments avec name, une description facultative et 2 à 4 element_input_urls, référencés par @name dans prompt. Ne combinez pas ces éléments avec output_audio=true.

URL publique de la vidéo source. Requise pour les flux video-to-video basés sur une URL vidéo et pour motion-control ; certains flux dérivés utilisent plutôt task_id.

Entrées vidéo de référence supplémentaires pour les modèles qui prennent en charge un conditionnement multimodal. Le nombre autorisé dépend du modèle. Pour seedance-2.0 et seedance-2.0-fast, TokenLab prend actuellement en charge jusqu'à 3 vidéos de référence.

URL audio publique pour une opération pilotée par l’audio ou une référence audio prise en charge par le modèle.

Entrées audio de référence supplémentaires pour les modèles qui prennent en charge un conditionnement multimodal. Le nombre autorisé dépend du modèle. Pour seedance-2.0 et seedance-2.0-fast, TokenLab prend actuellement en charge jusqu'à 3 audios de référence.

Identifiant de tâche utilisé par certains flux de continuation, d’extension ou dérivés.

Offset de départ spécifique au modèle pour certains flux video-extension.

Multiplicateur ou nombre de répétitions spécifique au modèle pour certains flux video-extension.

Durée de la vidéo générée en secondes. Pour les modèles Seedance 1.5/2.0, l’omission de ce champ utilise 5; envoyer -1 laisse le modèle choisir dans sa plage prise en charge, et la facturation est estimée de façon conservatrice jusqu’à la fin de la tâche.

Alias compatible de duration. Si seconds et duration sont envoyés ensemble, ils doivent être identiques. Pour Seedance, seconds=-1 a le même sens de durée automatique que duration=-1.

Format d’image canonique, par exemple adaptive, 16:9, 9:16, 1:1, 4:3, 3:4 ou 21:9. Seedance utilise adaptive par défaut lorsque ce champ est omis.

Résolution de sortie dépendante du modèle. Seedance utilise 720p par défaut ; seedance-2.0 prend en charge 480p, 720p, 1080p et 4k, tandis que seedance-2.0-fast et seedance-2.0-mini sont limités à 480p et 720p.

Sélecteur de sortie audio pour les opérations qui le déclarent. Sans valeur, le comportement par défaut du modèle s’applique. false demande une sortie silencieuse uniquement si elle est permise. Voir les précisions ci-dessus et la fiche du modèle.

Sélecteur du workflow Draft de Seedance 1.5 Pro. Utilisez draft=true avec les modèles Seedance compatibles avec les tâches draft. Ne l'envoyez pas avec draft_task_id.

ID de tâche draft Seedance 1.5 Pro à promouvoir. Envoyez l'ID d'une tâche draft précédente pour créer la vidéo finale ; ce n'est pas un champ vidéo générique.

Alias compatible de aspect_ratio. Si ratio et aspect_ratio sont envoyés ensemble, ils doivent être identiques.

Alias compatible de output_audio. Si generate_audio, output_audio et outputAudio apparaissent ensemble, toutes les valeurs doivent correspondre.

Fenêtre optionnelle d’expiration d’exécution en secondes pour les modèles vidéo compatibles. Seedance utilise 172800 secondes par défaut lorsque le champ est omis.

Priorité optionnelle de tâche de 0 à 9 pour les modèles vidéo compatibles. Ne combinez pas priority avec service_tier=flex.

Identifiant optionnel de sécurité de l’utilisateur final pour les modèles vidéo compatibles. S’il est omis pour Seedance, TokenLab utilise user lorsqu’il est fourni.

default est accepté comme no-op compatible pour les modèles Seedance 2.0. flex n’est autorisé que lorsque le modèle sélectionné le prend en charge.

Nombre optionnel d’images pour les modèles vidéo compatibles. Les modèles Seedance 2.0 et Seedance 1.5 Pro ne prennent pas ce champ en charge.

Sélecteur optionnel de caméra fixe pour les modèles vidéo compatibles. Les modèles Seedance 2.0 ne prennent pas ce champ en charge.

Fréquence d’images (1–120). N’a d’effet que sur les modèles qui l’exposent publiquement.

Éléments à éviter dans la génération.

Graine aléatoire pour une génération reproductible. Seedance utilise -1 comme graine aléatoire lorsque le champ est omis.

Intensité de suivi du prompt (0–20), effective uniquement sur les modèles qui la prennent en charge.

Intensité du mouvement (0–1), effective uniquement sur les modèles compatibles.

URL de l’image de premier frame, ou entrée image compatible, pour start-end-to-video.

URL de l’image de dernier frame, ou entrée image compatible, pour start-end-to-video.

Niveau de taille propre au modèle pour les modèles vidéo compatibles.

Option de filigrane pour les modèles qui l’exposent. Seedance utilise false par défaut lorsque le champ est omis.

Sélecteur d’effet spécifique au modèle pour certains flux d’édition ou d’effets.

Identifiant unique de l’utilisateur final. Pour Seedance, TokenLab utilise aussi cette valeur comme safety_identifier lorsque ce champ est omis.

Identifiant canonique de tâche asynchrone. Lorsque id et task_id sont tous les deux présents, considérez-les comme la même tâche.

Identifiant unique du task pour le polling.

URL de polling recommandée pour ce task. Utilisez ce chemin tel quel lors des vérifications d’état.

ID de transaction de facturation TokenLab lorsque le règlement est déjà terminé. Il s'agit de l'identifiant utilisé pour le dashboard / le rapprochement, distinct de l'id / task_id asynchrone.

Statut de la tâche : pending, processing, completed, failed.

Timestamp Unix de création de la tâche.

Modèle utilisé.

Charge utile d'une seule vidéo avec url, duration, width et height lorsque disponible.

Plusieurs charges utiles vidéo lorsque la tâche de génération renvoie plus d'une sortie.

Message d'erreur (en cas d'échec).