Créer une vidéo

Aperçu

La génération de vidéo prend du temps. Une réponse de création réussie renvoie un ID de tâche et une poll_url ; utilisez cette URL pour vérifier la progression et récupérer le résultat.

Vérifier le statut de la tâche

Appelez la poll_url présente dans la réponse de création. id et task_id identifient la même tâche ; vous pouvez également utiliser GET /v1/tasks/{id}.

Entrée audio et média

Le comportement audio dépend du modèle et de l’opération. Une vidéo peut contenir du son sans sélecteur audio. Omettre un champ n’équivaut pas à envoyer false.

veo3.1 et veo3.1-fast génèrent toujours du son selon le contrat Gemini API. La génération vidéo de wan-2.6 et wan-2.7 ne permet pas non plus de désactiver le son. Omettez output_audio ou utilisez true si la fiche du modèle le permet.
hailuo-h3 et les modèles vidéo Grok génèrent du son natif. N’ajoutez pas de sélecteur absent de la fiche du modèle.
Seedance 1.5/2.x et viduq3-pro / viduq3-turbo activent le son par défaut et permettent une sortie silencieuse. PixVerse C1/V5.6/V6 désactivent le son par défaut. Utilisez output_audio uniquement pour les opérations qui le déclarent ; Vidu accepte aussi son champ booléen déclaré audio.
audio_url / audio_urls fournissent une entrée ou une référence audio, pas un interrupteur de sortie. Le montage, le transfert de mouvement et de style peuvent conserver la piste d’origine. Conserver le son d’origine ne signifie pas le couper.

Consultez la fiche du modèle pour les valeurs autorisées et les tarifs audio. Les alias pris en charge outputAudio, generate_audio et le booléen audio doivent correspondre à output_audio lorsqu’ils sont combinés. Les contrôles varient selon la version et l’opération.

Utilisez des URL https accessibles publiquement pour les images, les vidéos et l'audio. Certains modèles acceptent également des URL data: en ligne ; les URL sont plus fiables pour les fichiers volumineux.

Corps de la requête

modelstringpar défaut: veo3.1

ID du modèle vidéo. Utilisez l'API Models pour connaître les modèles actuels et operation pour les modes de génération texte-vers-vidéo, image-vers-vidéo, et autres.

PixVerse

Modèle: pixverse-c1, pixverse-v6, pixverse-v5.6
Opérations: text-to-video, image-to-video, start-end-to-video, reference-to-video
Sélecteur audio: output_audio, false par défaut

Sur TokenLab, les modèles PixVerse ci-dessus n'acceptent pas operation=video-extension.

HappyHorse

Modèle: happyhorse-1.0
Opérations: text-to-video, image-to-video, reference-to-video, video-to-video
Sélecteur audio: Ne pas envoyer output_audio

promptstring

Description textuelle de la vidéo à générer. Requis pour la plupart des modèles vidéo publics.

operationstring

Mode de génération. Les valeurs prises en charge incluent text-to-video, image-to-video, reference-to-video, start-end-to-video, video-to-video, video-extension, audio-to-video, et motion-control. Si omis, TokenLab l'infère à partir des entrées. L'envoyer explicitement permet de détecter plus tôt les champs incompatibles.

image_urlstring

URL accessible publiquement de l'image de départ pour la génération image-vers-vidéo. Pour les ressources matérielles Seedance, vous pouvez également transmettre asset://asset-YYYYMMDDHHMMSS-xxxxx pour utiliser un matériel TokenLab ACTIVE comme première image. Pour une meilleure compatibilité entre les modèles, préférez image_url avec une URL https.

imagestring

Image en ligne sous forme d'URL de données (par exemple, data:image/jpeg;base64,...). Pris en charge par les modèles compatibles, mais image_url offre la plus large compatibilité parmi les modèles vidéo publics.

reference_imagesarray

Entrées d'images de référence pour les modèles prenant en charge le conditionnement de référence dédié. Le nombre pris en charge 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. Chaque référence Seedance peut être une URL https ou un URI asset://asset-YYYYMMDDHHMMSS-xxxxx pour un matériel TokenLab ACTIVE. Pour la sélection de modèle, les limites 4K et les notes Mini, consultez le guide des modèles vidéo Seedance 2.0. Les URL https publiques sont recommandées pour les entrées non matérielles ; les modèles compatibles acceptent également les URL data: en ligne. Pour grok-imagine-video, reference-to-video accepte jusqu'à 7 références d'image et la duration est plafonnée à 10 secondes. grok-imagine-video-1.5-preview est uniquement image-vers-vidéo et n'accepte pas d'images de référence.

material_asset_idstring

ID de ressource matérielle TokenLab Seedance renvoyé par Créer une ressource matérielle. Utilisez-le une fois que la ressource est ACTIVE avec les modèles Seedance pouvant utiliser la bibliothèque de matériaux TokenLab. Ce champ est une entrée de référence générique ; pour attribuer explicitement la sémantique de première image, dernière image ou image de référence, placez asset://<material_asset_id> dans start_image, end_image ou reference_images à la place.

material_asset_idsarray

Plusieurs ID de ressources matérielles TokenLab Seedance. Ils partagent la même limite de référence d'image Seedance que reference_images ; le modèle sélectionné doit être capable d'utiliser la bibliothèque de matériaux TokenLab.

Les URL d'image ordinaires sont transmises en tant qu'entrées d'image ; elles ne créent pas de ressources matérielles réutilisables. Créez des ressources réutilisables via l'API de matériaux, puis utilisez leurs ID TokenLab ou leurs URI asset://asset-YYYYMMDDHHMMSS-xxxxx. Si des matériaux explicites renvoient 409 seedance_material_preparing, vérifiez les inactive_asset_ids renvoyés et réessayez une fois que ces matériaux sont devenus ACTIVE.

reference_image_typestring

Rôle de référence optionnel pour les modèles qui distinguent les références asset et style.

kling_elementsarray

Utilisez kling_elements uniquement lorsque les détails publics actuels du modèle sélectionné listent ce champ. Fournissez des entrées d'image et 1 à 3 éléments, chacun avec un name, une description optionnelle et 2 à 4 element_input_urls ; référencez-les sous la forme @name dans le prompt. Ne combinez pas les références d'élément avec output_audio=true.

video_urlstring

URL accessible publiquement de la vidéo source. Requis pour les flux video-to-video basés sur une URL vidéo et pour motion-control ; certains flux dérivés utilisent task_id à la place.

video_urlsarray

Entrées vidéo de référence supplémentaires pour les modèles prenant en charge le conditionnement de référence multimodal. Le nombre pris en charge 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.

audio_urlstring

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 sélectionné.

audio_urlsarray

Entrées audio de référence supplémentaires pour les modèles prenant en charge le conditionnement de référence multimodal. Le nombre pris en charge 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.

task_idstring

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

extend_atinteger

Décalage de début d'extension spécifique au modèle utilisé par certains flux video-extension.

extend_timesstring

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

durationinteger

Durée de la vidéo générée en sortie, en secondes. Pour les modèles Seedance 1.5/2.0, l'omission de ce champ utilise 5 ; envoyer -1 permet au modèle de choisir dans sa plage de durée prise en charge, et la facturation est estimée de manière prudente jusqu'à ce que la tâche soit terminée.

secondsinteger

Alias de compatibilité pour duration. Si seconds et duration sont tous deux envoyés, ils doivent être identiques. Pour Seedance, seconds=-1 a la même signification de durée automatique que duration=-1.

aspect_ratiostring

Format d'image, par exemple adaptive, 16:9, 9:16, 1:1, 4:3, 3:4, ou 21:9. Seedance utilise adaptive par défaut lorsqu'il est omis.

resolutionstring

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.

output_audioboolean

Sélecteur de sortie audio pour les opérations qui le déclarent. L'omission suit la valeur par défaut du modèle ; false demande une sortie silencieuse uniquement lorsque cela est autorisé. Voir le comportement audio ci-dessus et les détails du modèle sélectionné.

draftboolean

Activer le mode brouillon Seedance 1.5 Pro. Ne pas envoyer avec draft_task_id.

draft_task_idstring

ID de tâche de promotion de brouillon Seedance 1.5 Pro. Envoyez un ID de tâche de brouillon précédent pour créer la vidéo finale ; ce n'est pas un champ vidéo générique.

ratiostring

Alias de compatibilité pour aspect_ratio. Si ratio et aspect_ratio sont tous deux envoyés, ils doivent être identiques.

generate_audioboolean

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

execution_expires_afterinteger

Expiration de l'exécution optionnelle en secondes pour les modèles vidéo compatibles. Seedance utilise 172800 secondes par défaut lorsqu'il est omis.

priorityinteger

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

safety_identifierstring

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

service_tierstring

default est accepté comme une opération sans effet de compatibilité pour les modèles Seedance 2.0. flex n'est autorisé que lorsque le modèle sélectionné le prend en charge.

framesinteger

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

camera_fixedboolean

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

fpsinteger

Images par seconde (1-120) pour les modèles qui exposent le contrôle FPS.

negative_promptstring

Ce qu'il faut éviter dans la vidéo générée.

seedinteger

Graine aléatoire pour une génération reproductible. Seedance utilise -1 pour une graine aléatoire lorsqu'il est omis.

cfg_scalenumber

Force d'adhérence au prompt (0-20) pour les modèles qui exposent un contrôle de type CFG.

motion_strengthnumber

Intensité du mouvement (0-1) pour les modèles qui l'exposent.

start_imagestring

URL ou entrée d'image compatible pour la première image dans start-end-to-video.

end_imagestring

URL ou entrée d'image compatible pour la dernière image dans start-end-to-video.

sizestring

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

watermarkboolean

Basculement de filigrane optionnel pour les modèles qui l'exposent. Seedance utilise false par défaut lorsqu'il est omis.

effect_typestring

Sélecteur d'effet spécifique au modèle pour les flux d'édition spécialisés.

userstring

Un identifiant unique pour l'utilisateur final. Pour Seedance, TokenLab utilise également cette valeur comme safety_identifier lorsque ce champ est omis.

Noms de champs compatibles

Les champs principaux utilisent snake_case : aspect_ratio, output_audio, reference_images, et reference_image_type.
Pour la compatibilité, TokenLab accepte également ratio, generate_audio, outputAudio, seconds, referenceImages, et referenceImageType.
Si un champ principal et son alias sont tous deux envoyés, leurs valeurs doivent correspondre.
Si operation est omis, TokenLab l'infère à partir des entrées.

Entrée média

Préférez les URL https accessibles publiquement aux base64 en ligne pour image_url, reference_images, video_url, et audio_url.
Évitez de mélanger le base64 en ligne et les URL distantes dans la même requête.
Gardez les URL de médias distants valides jusqu'au début du traitement de la tâche.

Paramètres Seedance

Pour les modèles Seedance 1.5/2.0, le point de terminaison unifié suit les noms de champs TokenLab tout en acceptant les alias de compatibilité seconds, ratio, et generate_audio. Les sélecteurs Seedance omis utilisent ces valeurs par défaut : duration=5, resolution=720p, aspect_ratio=adaptive, output_audio=true, watermark=false, return_last_frame=false, execution_expires_after=172800, priority=0, et seed=-1.

duration=-1 ou seconds=-1 permet à Seedance de choisir la durée de sortie dans la plage prise en charge par le modèle. TokenLab estime le coût de manière prudente avant que la tâche ne soit terminée, puis effectue le règlement à partir de l'utilisation de la tâche terminée lorsqu'elle est disponible. service_tier=default est accepté pour Seedance 2.0 comme une opération sans effet de compatibilité ; service_tier=flex, frames, et camera_fixed sont rejetés lorsque le modèle sélectionné ne les prend pas en charge.

Exemple Seedance

cURL

curl -X POST "https://api.tokenlab.sh/v1/videos/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "A sleek product reveal with cinematic camera movement",
    "operation": "text-to-video",
    "duration": -1,
    "aspect_ratio": "adaptive",
    "resolution": "720p",
    "output_audio": true
  }'

Réponse

Les champs décrivant les résultats, les erreurs, les horodatages et le modèle sont renvoyés lorsqu'ils sont disponibles pour la tâche.

idstring

Identifiant de tâche asynchrone canonique. Traitez-le comme la même identité que task_id lorsque les deux sont présents.

task_idstring

Identifiant de tâche asynchrone canonique pour le sondage. Il s'agit de la même identité de tâche utilisée par les points de terminaison de statut asynchrone.

poll_urlstring

URL de sondage préférée pour cette tâche. Utilisez ce chemin exact lors de la vérification du statut.

billing_transaction_idstring

ID de transaction de facturation TokenLab lorsque le règlement est déjà terminé. Il s'agit de l'identifiant de transaction du tableau de bord/comptabilité et il est distinct de l'ID / task_id asynchrone.

statusstring

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

createdinteger

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

modelstring

Modèle utilisé.

video_urlstring

URL vidéo directe lorsque le résultat est déjà disponible.

videoobject

Résultat vidéo unique avec url, duration, width, et height lorsqu'il est disponible.

videosarray

Résultats vidéo multiples lorsque la tâche renvoie plus d'une sortie.

errorstring | object

Message d'erreur ou objet d'erreur structuré lorsque la tâche échoue.

Requête

curl -X POST "https://api.tokenlab.sh/v1/videos/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo3.1",
    "prompt": "A cat walking through a garden, cinematic lighting",
    "operation": "text-to-video",
    "duration": 4,
    "aspect_ratio": "16:9"
  }'

Réponse

Response

{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "model": "veo3.1",
  "created": 1706000000
}

Image vers vidéo

response = requests.post(
    "https://api.tokenlab.sh/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "hailuo-2.3",
        "prompt": "The scene begins from the provided image and adds gentle natural motion.",
        "operation": "image-to-video",
        "image_url": "https://example.com/image.jpg",
        "duration": 6,
        "resolution": "768p"
    }
)

Éléments Kling 3.0

Référence vers vidéo

Utilisez operation=reference-to-video lorsque le modèle prend en charge le conditionnement de référence dédié. Dans les requêtes TokenLab, les références d'image utilisent reference_images, tandis que les vidéos et audios de référence multimodaux utilisent video_urls et audio_urls. 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 la sélection de modèle, les limites 4K et les notes Mini, consultez le guide des modèles vidéo Seedance 2.0. duration contrôle uniquement la longueur de la sortie générée ; elle ne définit pas de limite distincte pour la durée de l'entrée vidéo de référence. Pour grok-imagine-video, reference-to-video accepte jusqu'à 7 références d'image (reference_images ou image_urls) et la duration est plafonnée à 10 secondes. Ne combinez pas les images de référence avec les entrées de première image image_url / image. grok-imagine-video-1.5-preview est uniquement image-vers-vidéo.

response = requests.post(
    "https://api.tokenlab.sh/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "veo3.1",
        "prompt": "Keep the same subject identity, palette, and framing while adding subtle natural motion.",
        "operation": "reference-to-video",
        "reference_images": [
            "https://example.com/ref-a.jpg",
            "https://example.com/ref-b.jpg"
        ],
        "reference_image_type": "asset",
        "duration": 8,
        "resolution": "720p",
        "aspect_ratio": "9:16"
    }
)

Contrôle des images clés

Utilisez start_image et end_image pour contrôler la première et la dernière image :

response = requests.post(
    "https://api.tokenlab.sh/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "viduq2-pro",
        "operation": "start-end-to-video",
        "start_image": "https://example.com/day.jpg",
        "end_image": "https://example.com/night.jpg",
        "duration": 5,
        "resolution": "720p",
        "aspect_ratio": "16:9"
    }
)

Vidéo vers vidéo

Pour grok-imagine-video vidéo-vers-vidéo, envoyez une URL .mp4 HTTPS publique dans video_url et le prompt d'édition. Omettez resolution, duration, et aspect_ratio pour cette opération.

Utilisez operation=video-to-video lorsque le modèle accepte une vidéo existante comme entrée principale.

response = requests.post(
    "https://api.tokenlab.sh/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "grok-imagine-video",
        "operation": "video-to-video",
        "video_url": "https://example.com/source.mp4",
        "prompt": "Enhance the clip while preserving the original motion."
    }
)

Contrôle du mouvement

Utilisez operation=motion-control lorsque le modèle attend à la fois une image de sujet et une vidéo de référence de mouvement. TokenLab mappe la forme de requête image_url + video_url publique au format de requête de contrôle de mouvement pour ce modèle.

response = requests.post(
    "https://api.tokenlab.sh/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "kling-3.0-motion-control",
        "operation": "motion-control",
        "prompt": "Keep the subject identity stable while following the motion reference.",
        "image_url": "https://example.com/subject.png",
        "video_url": "https://example.com/motion.mp4",
        "resolution": "720p"
    }
)

Découverte de modèles

L'inventaire vidéo public et les opérations prises en charge changent avec le temps. Utilisez l'API Models pour vérifier la prise en charge actuelle avant de configurer un flux spécifique au modèle :

curl "https://api.tokenlab.sh/v1/models?recommended_for=video"

curl "https://api.tokenlab.sh/v1/models/veo3.1"

Lisez la réponse détaillée du modèle avant de vous fier à des opérations ou des champs spécifiques au modèle. Les opérations telles que audio-to-video et video-extension sont spécifiques au modèle ; confirmez leur disponibilité actuelle à cet endroit plutôt que de vous fier aux exemples statiques de cette page.

Autorisation

BearerAuth

AuthorizationBearer <token>

Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.

Emplacement: header

En-têtes

X-TokenLab-Delivery-Policy?string

Politique de livraison par requête. Remplace les valeurs par défaut de la clé API et de l'espace de travail. Tente automatiquement TokenLab Verified en premier et peut basculer une fois vers Official uniquement avant la sortie, l'acceptation de la requête ou la création de ressource persistante.

Valeurs possibles

"auto"
"verified"
"official"

Corps de la requête

application/json

prompt?string

Description de la vidéo

model?string

Modèle à utiliser (par ex. veo3.1, kling-v1)

operation?string

Opération vidéo demandée. Si omis, TokenLab déduit l'opération à partir des entrées fournies. Une opération explicite est recommandée pour la fiabilité en production.

Valeurs possibles

"text-to-video"
"image-to-video"
"reference-to-video"
"start-end-to-video"
"video-to-video"
"video-extension"
"audio-to-video"
"motion-control"

image?string

Image en ligne sous forme d'URL de données (par exemple, data:image/png;base64,...). Préférez image_url pour une compatibilité de production plus large. Lorsque le modèle Seedance sélectionné peut utiliser la bibliothèque de matériaux TokenLab, TokenLab prépare cette entrée d'image comme un matériau réutilisable avant la génération ; s'il n'est pas ACTIVE dans les 60 secondes, l'API renvoie 409 seedance_material_preparing avec auto_material_asset_ids. Si le modèle sélectionné ne peut pas utiliser la bibliothèque de matériaux, les entrées d'image ordinaires suivent le chemin d'image habituel.

image_url?string

URL d'image accessible publiquement pour la génération image-à-vidéo, ou asset://asset-YYYYMMDDHHMMSS-xxxxx pour un matériau TokenLab Seedance ACTIVE utilisé comme première image. Préféré au base64 en ligne en production. TokenLab vérifie la propriété du matériau. Lorsque le modèle Seedance sélectionné peut utiliser la bibliothèque de matériaux TokenLab, TokenLab prépare l'entrée d'image ordinaire comme un matériau réutilisable avant la génération ; s'il n'est pas ACTIVE dans les 60 secondes, l'API renvoie 409 seedance_material_preparing avec auto_material_asset_ids. Si le modèle sélectionné ne peut pas utiliser la bibliothèque de matériaux, les entrées d'image ordinaires suivent le chemin d'image habituel.

Formaturi

video_url?string

URL de vidéo accessible publiquement pour les flux de style vidéo-à-vidéo et les modèles de contrôle de mouvement.

Formaturi

duration?integer

Durée de la vidéo en secondes. Les modèles Seedance acceptent également -1 pour laisser le modèle choisir dans sa plage de durée prise en charge ; TokenLab estime la facturation de manière prudente pour ce mode.

Plage-1 <= value <= 60

aspect_ratio?string

Rapport d'aspect vidéo canonique. Seedance utilise adaptive par défaut lorsqu'il est omis. L'alias ratio est accepté pour la compatibilité.

Valeurs possibles

"adaptive"
"16:9"
"9:16"
"1:1"
"4:3"
"3:4"
"21:9"

resolution?string

Résolution vidéo. Seedance utilise 720p par défaut lorsqu'il est omis ; les valeurs disponibles dépendent du modèle.

Valeurs possibles

"480p"
"720p"
"1080p"
"4k"

output_format?string

Format de conteneur vidéo pour les modèles compatibles. Seedance 2.5 prend en charge mp4 et mov ; omettez ce champ pour Seedance 2.0 et les autres modèles qui ne publient pas de sélecteur de format de sortie.

Valeurs possibles

"mp4"
"mov"

output_audio?boolean

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.

fps?integer

Images par seconde

Plage1 <= value <= 120

negative_prompt?string

Ce qu'il faut éviter dans la vidéo

seed?integer

Graine (seed) pour la reproductibilité sur les modèles compatibles. Les modèles Seedance compatibles utilisent -1 pour une graine aléatoire lorsqu'elle est omise ; Seedance 2.5 ne prend pas en charge ce champ.

Plage-1 <= value <= 4294967295

cfg_scale?number

Force d'adhérence au prompt (0-20) pour les modèles qui exposent un contrôle de type CFG.

Plage0 <= value <= 20

motion_strength?number

Intensité du mouvement (0-1) pour les modèles qui l'exposent.

Plage0 <= value <= 1

start_image?string

Entrée d'image de la première image pour les flux début-fin-à-vidéo. Seedance accepte une référence d'image publique ou asset://asset-YYYYMMDDHHMMSS-xxxxx pour un matériau TokenLab ACTIVE appartenant à l'organisation demandeuse. Lorsque le modèle Seedance sélectionné peut utiliser la bibliothèque de matériaux TokenLab, TokenLab prépare l'entrée d'image ordinaire comme un matériau réutilisable avant la génération ; s'il n'est pas ACTIVE dans les 60 secondes, l'API renvoie 409 seedance_material_preparing avec auto_material_asset_ids. Si le modèle sélectionné ne peut pas utiliser la bibliothèque de matériaux, les entrées d'image ordinaires suivent le chemin d'image habituel.

end_image?string

Image de la dernière trame pour les flux start-end-to-video. Seedance accepte une référence d'image publique ou asset://asset-YYYYMMDDHHMMSS-xxxxx pour un matériel TokenLab ACTIF appartenant à l'organisation demandeuse. Lorsque le modèle Seedance sélectionné peut utiliser la bibliothèque de matériel TokenLab, TokenLab prépare l'image d'entrée ordinaire en tant que matériel réutilisable avant la génération ; si elle n'est pas ACTIVE dans les 60 secondes, l'API renvoie 409 seedance_material_preparing avec auto_material_asset_ids. Si le modèle sélectionné ne peut pas utiliser la bibliothèque de matériel, les entrées d'image ordinaires suivent le chemin d'image habituel.

user?string

Identifiant de l'utilisateur final

image_urls?array<>

Tableau d'URL d'images pour les flux vidéo conditionnés par image compatibles. Seedance 2.5 accepte jusqu'à 30 entrées d'image agrégées ; les autres modèles vidéo conservent la limite partagée de 9 entrées, sauf si les détails du modèle spécifient une limite inférieure. Lorsque le modèle Seedance sélectionné peut utiliser la bibliothèque de matériel TokenLab, TokenLab prépare cette entrée d'image en tant que matériel réutilisable avant la génération ; si elle n'est pas ACTIVE dans les 60 secondes, l'API renvoie 409 seedance_material_preparing avec auto_material_asset_ids. Si le modèle sélectionné ne peut pas utiliser la bibliothèque de matériel, les entrées d'image ordinaires suivent le chemin d'image habituel.

Éléments1 <= items <= 30

kling_elements?array<>

Références d'éléments Kling 3.0 pour les requêtes conditionnées par image kling-3.0-video. Définissez 1 à 3 éléments et référencez-les dans le prompt avec @name. Chaque élément nécessite 2 à 4 URL d'image dans element_input_urls. Ne combinez pas kling_elements avec output_audio=true ; omettez output_audio ou réglez-le sur false pour les requêtes avec référence d'élément.

Éléments1 <= items <= 3

reference_images?array<string>

Champ canonique d'image de référence publique pour le conditionnement reference-to-video. Seedance 2.5 accepte jusqu'à 30 entrées d'image agrégées ; les autres modèles vidéo conservent la limite partagée de 9 URL ou URL de données compatibles, sauf si les détails du modèle spécifient une limite inférieure. xAI grok-imagine-video accepte jusqu'à 7 références d'image avec une durée plafonnée à 10 secondes ; grok-imagine-video-1.5 et grok-imagine-video-1.5-preview sont uniquement image-to-video et n'acceptent pas d'images de référence. Lorsque le modèle Seedance sélectionné peut utiliser la bibliothèque de matériel TokenLab, TokenLab prépare l'image d'entrée ordinaire en tant que matériel réutilisable avant la génération ; si elle n'est pas ACTIVE dans les 60 secondes, l'API renvoie 409 seedance_material_preparing avec auto_material_asset_ids. Si le modèle sélectionné ne peut pas utiliser la bibliothèque de matériel, les entrées d'image ordinaires suivent le chemin d'image habituel.

Éléments1 <= items <= 30

material_asset_id?string

ID d'actif matériel TokenLab Seedance renvoyé par /v1/videos/assets, par préparation automatique d'image, ou à partir d'un groupe de personnes réelles renvoyé par GetVisualValidateResult. Utilisez-le une fois que l'actif est ACTIF avec les modèles Seedance capables d'utiliser la bibliothèque de matériel TokenLab. L'actif doit appartenir au compte actuel. Ce champ est une entrée de référence générique ; pour assigner explicitement une sémantique de première trame, dernière trame ou image de référence, placez asset://<material_asset_id> dans start_image, end_image ou reference_images.

material_asset_ids?array<string>

ID d'actifs matériels TokenLab Seedance renvoyés par /v1/videos/assets ou par préparation automatique d'image. Ils partagent la limite de référence d'image de Seedance ; le modèle sélectionné doit être capable d'utiliser la bibliothèque de matériel TokenLab et tous les actifs doivent appartenir au compte actuel et être ACTIFS.

Éléments1 <= items <= 9

reference_image_type?string

Rôle optionnel de l'image de référence pour les modèles qui distinguent les références d'actif et de style. L'alias camelCase referenceImageType est accepté pour des raisons de compatibilité.

Valeurs possibles

"asset"
"style"

audio_url?string

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.

Formaturi

task_id?string

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

extend_at?integer

Décalage de début d'extension spécifique au modèle utilisé par certains flux d'extension vidéo.

Plage0 <= value

extend_times?string

Multiplicateur ou nombre de répétitions d'extension spécifique au modèle utilisé par certains flux d'extension vidéo.

seconds?integer

Alias de duration utilisé par les formes de requête compatibles. Les modèles Seedance acceptent également -1 pour laisser le modèle choisir dans sa plage de durée prise en charge ; duration et seconds doivent correspondre lorsqu'ils sont tous deux fournis.

Plage-1 <= value <= 60

size?string

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

watermark?boolean

Bascule de filigrane optionnelle pour les modèles qui l'exposent. Seedance est défini sur false par défaut lorsqu'il est omis.

effect_type?string

Sélecteur d'effet spécifique au modèle pour les flux d'édition spécialisés.

video_urls?array<>

Tableau de compatibilité pour les flux conditionnés par vidéo lorsque plusieurs vidéos d'entrée sont prises en charge par le modèle sélectionné. Seedance 2.5 accepte jusqu'à 10 entrées vidéo agrégées ; les autres modèles vidéo conservent la limite partagée de 3 références, sauf si les détails du modèle spécifient une limite inférieure.

Éléments1 <= items <= 10

audio_urls?array<>

Tableau de compatibilité pour les flux conditionnés par audio lorsque plusieurs références audio sont prises en charge par le modèle sélectionné. Seedance 2.5 accepte jusqu'à 10 entrées audio agrégées et autorise les requêtes de référence purement audio sans prompt ; les autres modèles vidéo conservent la limite partagée de 3 références, sauf si les détails du modèle spécifient une limite inférieure.

Éléments1 <= items <= 10

ratio?string

Alias de compatibilité pour aspect_ratio. Si ratio et aspect_ratio sont tous deux fournis, ils doivent correspondre.

Valeurs possibles

"adaptive"
"16:9"
"9:16"
"1:1"
"4:3"
"3:4"
"21:9"

outputAudio?boolean

Alias de compatibilité pour output_audio. Si les deux sont fournis, ils doivent correspondre.

generate_audio?boolean

Alias de compatibilité pour output_audio. Si plus d'une bascule audio est fournie, toutes les valeurs doivent correspondre.

execution_expires_after?integer

Fenêtre d'expiration d'exécution optionnelle en secondes pour les modèles vidéo compatibles. Seedance est défini sur 172800 secondes par défaut lorsqu'il est omis.

Plage3600 <= value <= 259200

par défaut172800

priority?integer

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

Plage0 <= value <= 9

par défaut0

safety_identifier?string

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

Longueurlength <= 128

service_tier?string

Niveau de service optionnel pour les modèles vidéo compatibles. service_tier=default est accepté comme une opération nulle de compatibilité pour Seedance 2.0 et Seedance 2.5 ; service_tier=flex est rejeté pour les deux modèles.

Valeurs possibles

"default"
"flex"

frames?integer

Nombre de trames optionnel pour les modèles vidéo compatibles. Seedance 1.5 Pro, Seedance 2.0 et Seedance 2.5 ne prennent pas en charge ce champ.

Plage1 <= value

camera_fixed?boolean

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

return_last_frame?boolean

Renvoie la dernière trame générée lorsque le modèle sélectionné le prend en charge. Seedance est défini sur false par défaut lorsqu'il est omis.

par défautfalse

draft?boolean

Indicateur de flux de travail draft pour Seedance 1.5 Pro. Uniquement pris en charge par les modèles Seedance prenant en charge les drafts ; draft=true crée une tâche de draft à faible coût.

par défautfalse

draft_task_id?string

ID de tâche de promotion de brouillon Seedance 1.5 Pro. Fournissez ceci au lieu de draft=true pour créer la vidéo finale à partir d'une tâche de brouillon précédente.

audio?boolean

bgm?boolean

Commande audio facultative. Acceptée uniquement si elle est déclarée pour le modèle et l’opération sélectionnés ; sa disponibilité peut varier selon l’opération.

audio_type?string

Commande audio facultative. Acceptée uniquement si elle est déclarée pour le modèle et l’opération sélectionnés ; sa disponibilité peut varier selon l’opération.

voice_id?string

Commande audio facultative. Acceptée uniquement si elle est déclarée pour le modèle et l’opération sélectionnés ; sa disponibilité peut varier selon l’opération.

Créer une vidéo

Aperçu

Vérifier le statut de la tâche

Entrée audio et média

Corps de la requête

Noms de champs compatibles

Entrée média

Paramètres Seedance

Exemple Seedance

Réponse

Image vers vidéo

Éléments Kling 3.0

Référence vers vidéo

Contrôle des images clés

Vidéo vers vidéo

Contrôle du mouvement

Découverte de modèles

Autorisation

En-têtes

Corps de la requête

Réponse

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

Créer une vidéo

AperçuCopy Anchor Link

Vérifier le statut de la tâcheCopy Anchor Link

Entrée audio et médiaCopy Anchor Link

Corps de la requêteCopy Anchor Link

Noms de champs compatiblesCopy Anchor Link

Entrée médiaCopy Anchor Link

Paramètres SeedanceCopy Anchor Link

Exemple SeedanceCopy Anchor Link

RéponseCopy Anchor Link

Image vers vidéoCopy Anchor Link

Éléments Kling 3.0Copy Anchor Link

Référence vers vidéoCopy Anchor Link

Contrôle des images clésCopy Anchor Link

Vidéo vers vidéoCopy Anchor Link

Contrôle du mouvementCopy Anchor Link

Découverte de modèlesCopy Anchor Link

AutorisationCopy Anchor Link

En-têtesCopy Anchor Link

Corps de la requêteCopy Anchor Link

RéponseCopy Anchor Link

200application/json

400application/json

401application/json

402application/json

409application/json

429application/json

500application/json

503application/json

Aperçu

Vérifier le statut de la tâche

Entrée audio et média

Corps de la requête

Noms de champs compatibles

Entrée média

Paramètres Seedance

Exemple Seedance

Réponse

Image vers vidéo

Éléments Kling 3.0

Référence vers vidéo

Contrôle des images clés

Vidéo vers vidéo

Contrôle du mouvement

Découverte de modèles

Autorisation

En-têtes

Corps de la requête

Réponse

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`