Génération de vidéos

Générez des vidéos à partir de texte ou d'images de manière asynchrone, avec audio, résolution et format d'image optionnels.

La génération de vidéos s'exécute de manière asynchrone : le point d'accès renvoie immédiatement un 202 avec un job.id, et la vidéo est rendue en arrière-plan. Interrogez GET /v1/jobs/:id (voir Tâches asynchrones) jusqu'à ce que status passe à completed ou failed. Le helper createAndWait(...) du SDK fait les deux en un seul appel.

La facturation se fait par seconde de sortie et dépend du modèle et de la résolution :

La page de chaque modèle affiche ses tarifs actuels — le tableau ci-dessus est un instantané. Si une tâche échoue après facturation (erreur en amont, dépassement de délai), les crédits débités sont automatiquement remboursés.

Limites par modèle

Chaque modèle accepte le tronc commun — prompt, duration, resolution, aspect_ratio, image_url — avec ses propres bornes. La résolution par défaut est celle facturée quand vous omettez le champ.

Un paramètre qu'un modèle n'accepte pas renvoie 400 bad_request en nommant le paramètre — rien n'est ignoré ni émulé en silence. hailuo-2.3 n'accepte que 6 ou 10 secondes en amont ; les autres valeurs de sa plage 6–10 sont rejetées par le fournisseur.

Paramètres

Facturation motion control

kling-v3-motion-control n'a pas de paramètre duration — en envoyer un renvoie un 400. La durée de sortie est déterminée par la vidéo de référence (plafonnée à 10 s avec character_orientation: "image", 30 s avec "video"), donc les crédits sont facturés en réserve puis remboursement :

1. À la soumission, la durée de la vidéo de référence est lue et ce nombre de secondes × le tarif par seconde est réservé (ex. une référence de 3 s en 1080p → 3 × 404 = 1 212 crédits). Si la durée est illisible, le plafond de l'orientation est réservé à la place (10 × 404 = 4 040 pour "image"). Votre solde doit couvrir la réserve.
2. À la fin, la durée réelle de la sortie est mesurée et la réserve est ajustée dans les deux sens : la partie inutilisée est remboursée, et un dépassement est facturé avant la livraison de la vidéo. Si votre solde ne couvre pas le dépassement, la tâche échoue avec error.code: "reserve_exceeded", la réserve est conservée et aucune vidéo n'est livrée — cela n'arrive que si les métadonnées de la vidéo de référence sous-estiment sa durée réelle.
3. La tâche terminée indique le débit net : tchavi.credits_used (net) et tchavi.credits_refunded, avec output.duration à la durée réelle. Si la tâche échoue, la réserve entière est remboursée.

const job = await client.videos.generations.createAndWait({
  model: 'kling-v3-motion-control',
  prompt: 'Le personnage exécute la danse en gardant exactement son apparence',
  resolution: '1080p',
  image_url: 'https://votre-hote.example.com/personnage.png',
  reference_video_url: 'https://votre-hote.example.com/reference-mouvement.mp4',
  character_orientation: 'image', // sortie max 10 s
  keep_original_sound: true,
  // pas de `duration` — la durée de sortie suit la vidéo de référence
});

console.log(job.output?.duration); // secondes réellement rendues
console.log(job.tchavi?.credits_used); // débit net après remboursement
console.log(job.tchavi?.credits_refunded); // partie inutilisée de la réserve

Exemple

import Tchavi from '@tchavi/sdk';

const client = new Tchavi({ apiKey: 'YOUR_API_KEY' });

// En une ligne : soumettre + interroger jusqu'à completed/failed
const job = await client.videos.generations.createAndWait({
  model: 'seedance-2',
  prompt: 'Un plan cinématographique de la statue de l\'Amazone de Cotonou à l\'heure dorée',
  duration: 5,
  resolution: '480p',
  aspect_ratio: '9:16',
  generate_audio: true,
});

if (job.status === 'completed') {
  console.log('URL de la vidéo :', job.output?.video_url);
  console.log('Crédits utilisés :', job.tchavi?.credits_used);
} else {
  console.error('Échec :', job.error?.message);
}