Trạng thái job video
Kiểm tra tiến độ của một job video. Chỉ chủ sở hữu job mới xem được.
Đã triển khai
Request
GET
/videos/generations/{jobId}Cần header Authorization: Bearer apl_...
| Field | Kiểu | Mô tả |
|---|---|---|
jobIdbắt buộc | string (path) | Job ID nhận được khi tạo. |
Response
| Field | Kiểu | Mô tả |
|---|---|---|
statusbắt buộc | "queued" | "running" | "completed" | "failed" | Trạng thái hiện tại. |
content_url | string | Chỉ có khi completed. Đường dẫn tải MP4 qua ApiLux. |
actual_duration_seconds | integer | Số giây thực tế, nếu nhà cung cấp báo về. |
apilux.credit_refundedbắt buộc | integer | Số credit đã hoàn (khác 0 khi job failed). |
Tính tiền
Miễn phí. Poll bao nhiêu lần cũng không bị trừ thêm.
Ví dụ
curl https://apilux.net/api/v1/videos/generations/vidjob_YOUR_JOB_ID \
-H "Authorization: Bearer apl_YOUR_API_KEY"Lỗi
| HTTP | Mã | Ý nghĩa |
|---|---|---|
| 401 | auth_missing_or_malformed | Thiếu header Authorization hoặc sai định dạng. Phải là Bearer apl_.... |
| 401 | auth_invalid | API key không tồn tại. |
| 401 | auth_revoked | API key đã bị thu hồi. |
| 401 | auth_expired | API key đã hết hạn. |
| 404 | not_found | Job không tồn tại, hoặc không thuộc về bạn — hai trường hợp trả về giống hệt nhau. |
| 502 | upstream_error | Nhà cung cấp mô hình lỗi. Không bị trừ tiền. |
| 504 | upstream_timeout | Nhà cung cấp không phản hồi kịp. Không bị trừ tiền. |
| 429 | upstream_rate_limited | Bị giới hạn tốc độ. Thử lại sau vài giây. |
Ghi chú
Nên poll mỗi 5 giây. Video thường xong sau 40–180 giây tuỳ model và độ dài.