Tâches asynchrones

Suivez l'état des opérations asynchrones comme la génération de vidéos via les points d'accès dédiés aux tâches.

Certains points d'accès — actuellement la génération de vidéos — s'exécutent de manière asynchrone. Ils répondent immédiatement avec un id de tâche et vous suivez leur achèvement via ces points d'accès.

Récupérer une tâche

Renvoie l'enregistrement complet de la tâche. La forme de la charge utile dépend de status :

• pending / processing — pas encore de output ; tchavi.credits_used est renseigné.
• completed — output.video_url, output.duration, output.resolution, output.file_size_mb, output.url_expires_at.
• failed — error.message, error.code, et tchavi.credits_refunded (les crédits débités sont restitués automatiquement).

Lister les tâches

Liste les tâches de l'appelant, les plus récentes en premier. Paramètres de requête : status (filtre), limit (1–50, par défaut 20), offset (par défaut 0).

Exemple

import Tchavi from '@tchavi/sdk';
const client = new Tchavi({ apiKey: 'YOUR_API_KEY' });

// Récupérer une tâche spécifique
const job = await client.jobs.retrieve('job_abc123');
console.log(job.status, job.output?.video_url);

// Lister les 10 tâches terminées les plus récentes
const { data } = await client.jobs.list({ status: 'completed', limit: 10 });
for (const j of data) {
  console.log(j.created_at, j.model, j.output?.video_url);
}

Voir Génération de vidéos pour le point d'accès qui produit ces tâches.