Truy xuất tác vụ tạo video
get/v1/video/generations/{task_id}
Truy xuất trạng thái và kết quả của một tác vụ tạo video.
Trạng thái tác vụ:
queued: đang chờ trong hàng đợiin_progress: đang tạocompleted: đã hoàn tấtfailed: thất bại
Xác thực
Gửi khóa API OLETOKEN dưới dạng token Bearer. Khóa được tạo tại trang API Keys trong bảng điều khiển.
Authorization: Bearer $OLETOKEN_API_KEYTham số
| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
| task_idpath | string | ID tác vụ |
Phản hồi
200Đã truy xuất trạng thái tác vụ
| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
| task_id | string | — | ID tác vụ |
| status | stringqueuedin_progresscompletedfailed | — | Trạng thái tác vụ |
| url | string | — | URL video (khi tác vụ thành công) |
| format | string | — | Định dạng video |
| metadata | VideoTaskMetadata | — | — |
| duration | number | — | Thời lượng video thực tế |
| fps | integer | — | Tốc độ khung hình thực tế |
| width | integer | — | Chiều rộng thực tế |
| height | integer | — | Chiều cao thực tế |
| seed | integer | — | Seed ngẫu nhiên đã được dùng |
| error | VideoTaskError | — | — |
| code | integer | — | Mã lỗi |
| message | string | — | Thông báo lỗi |
404Không tìm thấy tác vụ
| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
| error | object | — | — |
| message | string | — | Thông báo lỗi |
| type | string | — | Loại lỗi |
| param | string | null | — | Tham số liên quan |
| code | string | null | — | Mã lỗi |
Ví dụ yêu cầu
curl -X GET 'https://api.oletoken.ai/v1/video/generations/{task_id}' \
-H "Authorization: Bearer $OLETOKEN_API_KEY"