UlazAI utviklerdokumenter
Arbeidsflyter for videostatus
Spor asynkrone videojobber
Video Studio-generering er asynkron. Skape arbeidsplasser med
/api/v1/video-studio/generate/, deretter avstemning
/api/v1/video-studio/status/{job_id}/ til hver jobb når
completed eller failed.
curl -X GET https://ulazai.com/api/v1/video-studio/status/YOUR_JOB_ID/ \
-H "Authorization: Bearer YOUR_API_KEY"
Livssyklustilstander
Jobbrad opprettet og satt i kø for leverandørinnsending.
Leverandøroppgaven kjører eller synkroniseres fortsatt.
Resultatnettadresser er tilgjengelige i job.result_urls.
Feilmelding er satt og kreditter kan bli refundert.
Eksempel på statussvar
{
"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"
}
}
Eksempel på feilsvar
{
"success": true,
"job": {
"job_id": "b1f74f1f-8a81-410c-a533-4701159ed7ba",
"status": "failed",
"error_message": "Invalid duration for this model",
"credits_refunded": true
}
}
Arbeidsflytendepunkter
Bruk disse endepunktene til å administrere mapper, oppryddingsjobber og kjøre fletteflyter.
| Metode | Sti | Formål |
|---|---|---|
| POST | /api/v1/video-studio/generate/ |
API-key/token endpoint for one or more Video Studio jobs (all supported video models). |
| FÅ | /api/v1/video-studio/status/{job_id}/ |
API-key/token polling endpoint for Video Studio job state and output URLs. |
| FÅ | /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. |
Avstemningsanbefalinger
- Start polling 3-5 sekunder etter jobboppretting.
- Bruk progressiv backoff (for eksempel 3s, 5s, 8s, deretter hver 10s).
- Stopp polling når status er
completedellerfailed. - Les
historyfor å laste inn jobbkort på nytt etter sideoppdatering.