Tải Video API
Tính năng Uploads API cung cấp cách thức để tải trực tiếp các tệp tin video và theo dõi trạng thái xử lý của chúng.
Tất cả các uploads đều được xử lý đồng thời. Bạn sẽ nhận được phản hồi ngay lập tức 202 Accepted, và video sẽ được xử lý ở nền tảng. Bạn nên sử dụng các điểm cuối để theo dõi tiến trình.
Tải Video
Điểm cuối này chấp nhận yêu cầu multipart/form-data để tải một tệp tin video mới.
POST /uploads
Request Body (multipart/form-data)
| Trường | Loại | Yêu cầu | Beschreibung |
|---|---|---|---|
video | file | Yes | Tệp tin video cần tải. |
folder | string | Yes | Đường dẫn thư mục nơi tệp tin video sẽ được đặt (ví dụ: root/my-folder). |
Ví dụ Yêu Cầu (.http)
POST /api/client/v1/uploads
Authorization: Bearer sk-your-api-key-here
Content-Type: multipart/form-data; boundary=...
... (form data với file và folder) ...Trả về: 202 Accepted
Điểm cuối này xác nhận tải video và trả về trạng thái ban đầu. Bạn nên lưu trữ id để kiểm tra trạng thái sau đó.
{
"message": "Tải video được chấp nhận và đang được xử lý.",
"data": {
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"status": 1,
"status_text": "pending"
}
}Lấy Trạng Thái Uploads
Lấy trạng thái của 50 upload gần đây nhất. Bạn có thể poll điểm cuối này để cập nhật UI.
GET /uploads
Ví dụ Yêu Cầu
GET /api/client/v1/uploads
Authorization: Bearer sk-your-api-key-hereTrả về: 200 OK
{
"data": [
{
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"filename": "my_new_video.mp4",
"status": 3,
"status_text": "processing",
"created_at": "2024-08-11T10:00:00Z",
"updated_at": "2024-08-11T10:01:00Z"
},
{
"id": "9c1fa5c3-b9f2-5c3f-8e7f-2d9b1c4e1f8e",
"filename": "my_previous_video.mp4",
"status": 6,
"status_text": "completed",
"created_at": "2024-08-10T15:00:00Z",
"updated_at": "2024-08-10T15:05:00Z"
}
]
}Lấy Trạng Thái Upload Tự Động
Lấy trạng thái của một video cụ thể bằng ID.
GET /uploads/{videoId}
Ví dụ Yêu Cầu
GET /api/client/v1/uploads/9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7fTrả về: 200 OK
{
"data": {
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"filename": "my_new_video.mp4",
"status": 6,
"status_text": "completed"
}
}Trạng Thái Tham khảo
| Mã trạng thái | Trạng thái văn bản | Beschreibung |
|---|---|---|
1 | pending | Tải video đang được xếp hàng và chờ xử lý. |
3 | processing | Video đang được chuyển mã. |
5 | uploading | Các tệp tin đã được chuyển mã đang được tải lên lưu trữ cuối cùng. |
6 | completed | Video đã được xử lý xong và sẵn sàng phát lại. |
7 | failed | Lỗi xảy ra trong quá trình xử lý. |