Lấy trạng thái tạo video

Poll một job video. Trạng thái kết thúc chỉ có completed / failed; khi đang chạy thường thấy pending / processing, nhưng nhãn đang xử lý của upstream (vd. in_progress) có thể đi qua — hãy viết vòng lặp là "đến khi completed hoặc failed" thay vì liệt kê trạng thái trung gian. Hủy/hết hạn phía upstream (cancelled / expired) hiển thị là failed và credit đã giữ được hoàn lại. Khi completed, unsigned_urls liệt kê đường dẫn nội dung tải được và usage.cost là số tiền cuối cùng (theo số giây thực giao); khi failed, error giải thích lý do. Máy chủ giới hạn truy vấn upstream 1 lần/8 giây; nên poll với khoảng cách ≥5 giây.

GET/api/v1/videos/:id

Xác thực

Authorizationbắt buộc

string · header

API key dưới dạng bearer token trong header Authorization.

Tham số đường dẫn

idbắt buộc

string

Id job trả về khi gửi (tiền tố vjob_). Chỉ xem được job thuộc cùng tài khoản.

Example: "vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk"

Hướng dẫn chi tiết →

GET /api/v1/videos/:id

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

Ví dụ phản hồi

Thành công. Ví dụ là job completed; phản hồi pending / processing không có unsigned_urls và usage, failed thêm trường error. unsigned_urls là đường dẫn tương đối — GET với cùng API key để tải xuống.

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