Vai al contenuto
UlazAI

Documenti per sviluppatori UlazAI

Flussi di lavoro relativi allo stato del video

Prezzi Pannello di controllo Studio d'immagine

Tieni traccia dei lavori video asincroni

La generazione di Video Studio è asincrona. Crea posti di lavoro con /api/v1/video-studio/generate/, quindi sondaggio /api/v1/video-studio/status/{job_id}/ fino a quando ogni lavoro raggiunge completed o failed. 

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

Stati del ciclo di vita

in sospeso

Riga di lavoro creata e in coda per l'invio al fornitore.

elaborazione

L'attività del provider è in esecuzione o è ancora in fase di sincronizzazione.

completato

Gli URL dei risultati sono disponibili in job.result_urls.

fallito

Viene impostato un messaggio di errore e i crediti possono essere rimborsati.

Esempio di risposta sullo stato

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

Esempio di risposta in caso di errore

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

Endpoint del flusso di lavoro

Utilizza questi endpoint per gestire cartelle, pulire processi ed eseguire flussi di unione.

Metodo Percorso Scopo
POST /api/v1/video-studio/generate/ API-key/token endpoint for one or more Video Studio jobs (all supported video models).
OTTIENI /api/v1/video-studio/status/{job_id}/ API-key/token polling endpoint for Video Studio job state and output URLs.
OTTIENI /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.

Raccomandazioni per i sondaggi

  • Inizia il polling 3-5 secondi dopo la creazione del lavoro.
  • Utilizzare il backoff progressivo (ad esempio 3, 5, 8, quindi ogni 10).
  • Interrompi il polling quando lo stato è completed o failed.
  • Leggi history per ricaricare le schede lavoro dopo l'aggiornamento della pagina.