Flux de travail sur l'état de la vidéo

Suivre les tâches vidéo asynchrones

La génération Video Studio est asynchrone. Créer des emplois avec /api/v1/video-studio/generate/, puis interrogez /api/v1/video-studio/status/{job_id}/ jusqu'à ce que chaque travail atteigne completed ou failed.

curl -X GET https://ulazai.com/api/v1/video-studio/status/YOUR_JOB_ID/ \
  -H "Authorization: Bearer YOUR_API_KEY"

États du cycle de vie

en attente

Ligne de travail créée et mise en file d'attente pour la soumission du fournisseur.

traitement

La tâche du fournisseur est en cours d'exécution ou est toujours en cours de synchronisation.

terminé

Les URL des résultats sont disponibles dans job.result_urls.

échoué

Un message d'erreur est défini et les crédits peuvent être remboursés.

Exemple de réponse d'état

{
  "success": true,
  "job": {
    "job_id": "8990f846-f6f0-4ff1-a298-d0a72d49e7ad",
    "model_slug": "kling_3_0",
    "mode": "text_to_video",
    "status": "completed",
    "result_urls": [
      "https://media.ulazai.com/video_studio/results/job-8990f846.mp4"
    ],
    "credits_charged": 100,
    "provider_meta": {
      "effective_duration_seconds": 5,
      "quality_mode": "std"
    },
    "created_at": "2026-02-20T12:40:01.123456+00:00",
    "completed_at": "2026-02-20T12:41:22.948211+00:00"
  }
}

Exemple de réponse à un échec

{
  "success": true,
  "job": {
    "job_id": "b1f74f1f-8a81-410c-a533-4701159ed7ba",
    "status": "failed",
    "error_message": "Invalid duration for this model",
    "credits_refunded": true
  }
}

Points de terminaison du flux de travail

Utilisez ces points de terminaison pour gérer les dossiers, les tâches de nettoyage et exécuter des flux de fusion.

Méthode	Chemin	Objectif
POSTER	`/api/v1/video-studio/generate/`	API-key/token endpoint for one or more Video Studio jobs (all supported video models).
OBTENIR	`/api/v1/video-studio/status/{job_id}/`	API-key/token polling endpoint for Video Studio job state and output URLs.
OBTENIR	`/api/v1/video-studio/history/`	API-key/token history endpoint for recent Video Studio jobs.
POSTER	`/video-studio/api/folders/`	Browser-session endpoint for creating folder buckets for generated videos.
POSTER	`/video-studio/api/merge/`	Browser-session endpoint for merging multiple completed clips into one output job.

Recommandations de sondage

Commencez à interroger 3 à 5 secondes après la création du travail.
Utilisez un recul progressif (par exemple 3 s, 5 s, 8 s, puis toutes les 10 s).
Arrêtez l'interrogation lorsque l'état est completed ou failed.
Lire history pour recharger les fiches de travail après l'actualisation de la page.