Génération de Vidéo

La génération de vidéo est asynchrone. POST /v1/videos/generations renvoie une identité de tâche publique et généralement un poll_url ; la vidéo finale apparaît dans les réponses de statut ultérieures. Lorsque le modèle Seedance sélectionné peut utiliser la bibliothèque de matériaux TokenLab, les URL d’image et les data URL inline compatibles sont préparées comme matériaux TokenLab réutilisables avant la génération. Si la préparation dépasse 60 secondes, réessayez lorsque les auto_material_asset_ids renvoyés sont ACTIVE. Si le modèle sélectionné ne peut pas utiliser la bibliothèque, les images ordinaires continuent sur le chemin image habituel.

Opérations prises en charge

Utilisez une operation explicite en production. TokenLab peut inférer certaines opérations à partir des entrées, mais des valeurs d’opération explicites rendent la validation, le support et les réessais plus clairs.

Opération	Entrée requise ou typique	Cas d’utilisation
`text-to-video`	`prompt`	Générer uniquement à partir de texte
`image-to-video`	`image_url` ou `image` compatible	Animer une image de départ
`reference-to-video`	`reference_images` et `video_urls` / `audio_urls` optionnels sur les modèles pris en charge	Conserver l’identité, le style ou les références d’actifs
`start-end-to-video`	`start_image`, `end_image`	Contrôler les premières et dernières images
`video-to-video`	`video_url` ou `task_id` spécifique au modèle	Transformer ou améliorer un clip existant
`motion-control`	`image_url` plus `video_url`	Appliquer une référence de mouvement à un sujet
`audio-to-video`	`audio_url`	Flux vidéo conditionnés par l’audio
`video-extension`	`task_id`, `extend_at`, ou champs d’extension spécifiques au modèle	Continuer une vidéo générée

Découverte de Modèle

curl "https://api.tokenlab.sh/v1/models?recommended_for=video" \\
  -H "Authorization: Bearer sk-your-api-key"

Utilisez les IDs de modèle affichés par TokenLab dans model, puis choisissez les variantes de fonctionnalité avec operation et les entrées média correspondantes. Exemples : wan-2.7, happyhorse-1.0, viduq3, viduq3-mix, pixverse-v6, kling-3.0-video, veo3.1 et seedance-2.0; n’utilisez pas de suffixes propres à une opération comme noms de modèles TokenLab. Lisez les détails du modèle sélectionné avant de vous fier à des champs spécialisés tels que reference_images, kling_elements, output_audio, duration, resolution, ou aspect_ratio.

Créer une Demande

curl https://api.tokenlab.sh/v1/videos/generations \\
  -H "Authorization: Bearer sk-your-api-key" \\
  -H "Content-Type: application/json" \\
  -d '{
    "model": "veo3.1",
    "operation": "text-to-video",
    "prompt": "Une prise de vue cinématographique calme d'un chat marchant dans un jardin ensoleillé",
    "duration": 4,
    "aspect_ratio": "16:9"
  }'

Pour les entrées multimédias en production, préférez les URL publiques https aux URL data: en ligne. Si vous utilisez des URL temporaires, gardez-les valides jusqu’à ce que TokenLab ait terminé la création de la tâche.

Entrées et Champs Spécifiques au Modèle

Les demandes de la famille Veo 3 sont par défaut audio activé lorsque output_audio est omis. Définissez-le explicitement lorsque le modèle prend en charge le basculement et que votre UX dépend du son.
kling_elements est pour les demandes d’images conditionnées kling-3.0-video. Référencez chaque élément dans prompt comme @name ; ne le combinez pas avec output_audio=true.
Pour la famille Seedance 2.0, lisez le guide des modèles vidéo Seedance 2.0 avant d’utiliser la sortie 4K, les limites Fast/Mini ou les entrées de référence multimodales.
Pour grok-imagine-video, la vidéo à vidéo utilise une video_url publique .mp4 ; les limites spécifiques au modèle telles que duration et resolution doivent provenir du détail du modèle.

PixVerse et HappyHorse

Modèle	Opérations	Entrées	Résolution	Durée	Sélecteur audio
`pixverse-c1`, `pixverse-v6`	`text-to-video`, `image-to-video`, `start-end-to-video`, `reference-to-video`	`prompt`; `image_url`; `start_image` + `end_image`; `reference_images`	360p, 540p, 720p, 1080p	Tout entier de 1 à 15 secondes	`output_audio`, `false` par défaut
`pixverse-v5.6`	`text-to-video`, `image-to-video`, `start-end-to-video`, `reference-to-video`	Mêmes champs que C1 et V6	360p, 540p, 720p, 1080p	5, 8 ou 10 secondes ; 1080p prend en charge 5 ou 8 secondes	`output_audio`, `false` par défaut
`happyhorse-1.0`	`text-to-video`, `image-to-video`, `reference-to-video`, `video-to-video`	`prompt`; `image_url`; `reference_images`; `video_url` + `reference_images`	720p, 1080p	3 à 15 secondes pour les opérations de génération ; la sortie video-to-video est limitée à 15 secondes	Ne pas envoyer `output_audio`

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

curl https://api.tokenlab.sh/v1/videos/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pixverse-v6",
    "operation": "image-to-video",
    "prompt": "A slow camera move through a neon-lit street",
    "image_url": "https://example.com/start.jpg",
    "resolution": "1080p",
    "duration": 5,
    "output_audio": true
  }'

Polling des Résultats

Utilisez d’abord le poll_url renvoyé. Si vous avez besoin d’un point de terminaison fixe, utilisez GET /v1/tasks/{id} avec le même id / task_id de la réponse de création. Les tâches vidéo terminées peuvent renvoyer video_url, video ou videos selon le modèle et le nombre de sorties. Traitez billing_transaction_id comme un identifiant de facturation, et non comme un identifiant de tâche.

Pièges Courants

Ne pas coder en dur les anciens chemins de statut vidéo ; préférez poll_url.
Ne pas combiner les champs de première image avec des flux d’images de référence dédiés à moins que le détail du modèle ne le permette.
Ne pas supposer que duration décrit la longueur de la vidéo de référence d’entrée ; il contrôle généralement la longueur de la sortie générée.
Ne pas réessayer les demandes de création après un délai d’attente sans vérifier si une tâche a déjà été créée.

Référence API

Sujet	Référence
Créer une Vidéo	Créer une Vidéo
Obtenir le Statut de la Vidéo	Obtenir le Statut de la Vidéo
Obtenir le Statut de la Tâche	Obtenir le Statut de la Tâche
Annuler la Tâche	Annuler la Tâche
Facturation & Tarification	Facturation & Tarification

APIs vidéo style OpenAI et compatibles Volc

Utilisez /v1/videos/generations pour l’API vidéo unifiée de TokenLab sur plusieurs modèles. Si vous migrez une intégration Seedance 2.0 qui utilise déjà content[] ou des requêtes Action de style Volc, utilisez les endpoints de compatibilité Seedance sous /api/v3. Les deux styles utilisent les clés TokenLab Bearer et le polling asynchrone, mais leurs formes de requête et de réponse diffèrent.

​Opérations prises en charge

​Découverte de Modèle

​Créer une Demande

​Entrées et Champs Spécifiques au Modèle

​PixVerse et HappyHorse

​Polling des Résultats

​Pièges Courants

​Référence API

​APIs vidéo style OpenAI et compatibles Volc