Fluxuri de lucru privind starea video

Urmăriți lucrări video asincrone

Generarea Video Studio este asincronă. Creați locuri de muncă cu /api/v1/video-studio/generate/, apoi sondaj /api/v1/video-studio/status/{job_id}/ până când fiecare loc de muncă ajunge completed sau failed.

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

Stările ciclului de viață

în aşteptare

Rând job creat și pus în coadă pentru trimiterea furnizorului.

prelucrare

Sarcina furnizorului rulează sau încă se sincronizează.

completat

Adresele URL ale rezultatelor sunt disponibile în job.result_urls.

a eșuat

Mesajul de eroare este setat și creditele pot fi rambursate.

Exemplu de răspuns de stare

{
  "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"
  }
}

Exemplu de răspuns la eșec

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

Puncte finale ale fluxului de lucru

Utilizați aceste puncte finale pentru a gestiona foldere, pentru a curăța lucrări și pentru a rula fluxuri de îmbinare.

Metoda	Calea	Scop
POSTĂ	`/api/v1/video-studio/generate/`	API-key/token endpoint for one or more Video Studio jobs (all supported video models).
GET	`/api/v1/video-studio/status/{job_id}/`	API-key/token polling endpoint for Video Studio job state and output URLs.
GET	`/api/v1/video-studio/history/`	API-key/token history endpoint for recent Video Studio jobs.
POSTĂ	`/video-studio/api/folders/`	Browser-session endpoint for creating folder buckets for generated videos.
POSTĂ	`/video-studio/api/merge/`	Browser-session endpoint for merging multiple completed clips into one output job.

Recomandări de sondaje

Începeți sondajul la 3-5 secunde după crearea locului de muncă.
Utilizați backoff-ul progresiv (de exemplu, 3s, 5s, 8s, apoi la fiecare 10s).
Opriți sondajele când starea este completed sau failed.
Citiți history pentru a reîncărca cardurile de muncă după reîmprospătarea paginii.