Ροές εργασιών κατάστασης βίντεο

Παρακολούθηση ασύγχρονων εργασιών βίντεο

Η δημιουργία του Video Studio είναι ασύγχρονη. Δημιουργία θέσεων εργασίας με /api/v1/video-studio/generate/, μετά δημοσκόπηση /api/v1/video-studio/status/{job_id}/ μέχρι να φτάσει κάθε δουλειά completed ή failed.

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

Καταστάσεις κύκλου ζωής

σε εκκρεμότητα

Δημιουργήθηκε σειρά εργασίας και τέθηκε σε ουρά για την υποβολή του παρόχου.

επεξεργασία

Η εργασία του παρόχου εκτελείται ή εξακολουθεί να συγχρονίζεται.

ολοκληρωθεί

Οι διευθύνσεις URL αποτελεσμάτων είναι διαθέσιμες στο job.result_urls.

απέτυχε

Το μήνυμα σφάλματος έχει οριστεί και οι πιστώσεις ενδέχεται να επιστραφούν.

Παράδειγμα απάντησης κατάστασης

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

Παράδειγμα απόκρισης αποτυχίας

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

Καταληκτικά σημεία ροής εργασιών

Χρησιμοποιήστε αυτά τα τελικά σημεία για να διαχειριστείτε φακέλους, να καθαρίσετε εργασίες και να εκτελέσετε ροές συγχώνευσης.

Μέθοδος	Μονοπάτι	Σκοπός
ΑΝΑΡΤΗΣΗ	`/api/v1/video-studio/generate/`	API-key/token endpoint for one or more Video Studio jobs (all supported video models).
ΠΑΡΕ	`/api/v1/video-studio/status/{job_id}/`	API-key/token polling endpoint for Video Studio job state and output URLs.
ΠΑΡΕ	`/api/v1/video-studio/history/`	API-key/token history endpoint for recent Video Studio jobs.
ΑΝΑΡΤΗΣΗ	`/video-studio/api/folders/`	Browser-session endpoint for creating folder buckets for generated videos.
ΑΝΑΡΤΗΣΗ	`/video-studio/api/merge/`	Browser-session endpoint for merging multiple completed clips into one output job.

Συστάσεις δημοσκοπήσεων

Ξεκινήστε τη ψηφοφορία 3-5 δευτερόλεπτα μετά τη δημιουργία θέσεων εργασίας.
Χρησιμοποιήστε προοδευτική υποχώρηση (για παράδειγμα 3s, 5s, 8s, μετά κάθε 10s).
Διακοπή ψηφοφορίας όταν είναι η κατάσταση completed ή failed.
Διαβάστε history για να φορτώσετε ξανά τις κάρτες εργασίας μετά την ανανέωση σελίδας.