Dapatkan status pembuatan video

Mem-poll job video. Satu-satunya status terminal adalah completed / failed; saat berjalan biasanya pending / processing, tetapi label upstream yang sedang berjalan (mis. in_progress) bisa lolos — tulis loop Anda sebagai "sampai completed atau failed" alih-alih menghitung status antara. Pembatalan/kedaluwarsa upstream (cancelled / expired) muncul sebagai failed dengan kredit yang dicadangkan dikembalikan. Saat completed, unsigned_urls mencantumkan path konten yang dapat diunduh dan usage.cost adalah tagihan final (berdasarkan detik yang benar-benar dikirim); saat failed, error menjelaskan alasannya. Pemeriksaan upstream dibatasi 1 per 8 dtk di sisi server; poll dengan interval ≥5 dtk.

GET/api/v1/videos/:id

Otorisasi

Authorizationwajib

string · header

API key sebagai bearer token di header Authorization.

Parameter path

idwajib

string

Id job yang dikembalikan saat pengiriman (awalan vjob_). Hanya job milik akun yang sama yang terlihat.

Example: "vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk"

Panduan mendalam →

GET /api/v1/videos/:id

1
2
curl https://bazaarlink.ai/api/v1/videos/vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY"

Contoh respons

Berhasil. Contoh menunjukkan job completed; respons pending / processing tidak memuat unsigned_urls dan usage, dan failed menambah field error. unsigned_urls adalah path relatif — GET dengan API key yang sama untuk mengunduh.

1
2
3
4
5
6
7
8
9
10
11
12
{
  "id": "vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk",
  "status": "completed",
  "polling_url": "/api/v1/videos/vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk",
  "unsigned_urls": [
    "/api/v1/videos/vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk/content?index=0"
  ],
  "usage": {
    "cost": 0.5,
    "is_byok": false
  }
}