API Module Guide
Mô-đun trung tâm tác vụ
Mô tả tính năng
Tiền tố API là https://88api.ai
Truy vấn các tác vụ không đồng bộ của tài khoản hiện tại (như tác vụ tạo video), có thể xem trạng thái, tiến độ, mức tiêu thụ và kết quả của tác vụ.
🔐 Xác thực người dùng
Nhận nhiệm vụ của tôi
- Tên giao diện: Nhận nhiệm vụ của tôi
- Phương thức HTTP: NHẬN
- Đường dẫn:
/api/task/self - Yêu cầu xác thực: Người dùng
- Mô tả chức năng: Truy xuất theo trang danh sách nhiệm vụ của người dùng hiện tại, hỗ trợ lọc theo nền tảng, ID nhiệm vụ, trạng thái và các điều kiện khác.
💡 Yêu cầu Ví dụ:
const response = await fetch('/api/task/self?p=1&page_size=20&task_id=cgt-20261014093000-x7k2m&status=SUCCESS&action=textGenerate&start_timestamp=1640908800&end_timestamp=1640995200', {
method: 'GET',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer your_user_token',
'New-Api-User': 'your_user_id'
}
});
const data = await response.json();✅ Ví dụ phản hồi thành công:
{
"success": true,
"message": "",
"data": {
"items": [
{
"id": 1,
"created_at": 1640908800,
"updated_at": 1640909000,
"task_id": "cgt-20261014093000-x7k2m",
"platform": "54",
"user_id": 1,
"quota": 1000,
"action": "textGenerate",
"status": "SUCCESS",
"fail_reason": "",
"submit_time": 1640908800,
"start_time": 1640908900,
"finish_time": 1640909000,
"progress": "100%",
"properties": {},
"data": {}
}
],
"total": 25,
"page": 1,
"page_size": 20
}
}❗ Ví dụ về phản hồi thất bại:
{
"success": false,
"message": "Failed to retrieve task list"
}🧾 Mô tả trường (Thông số yêu cầu):
p(Number): Số trang, mặc định là 1page_size(Number): Số mục trên một trang, mặc định là 20platform(String): Mã nền tảng tác vụ, tùy chọn, thường không cần điềntask_id(String): Bộ lọc ID tác vụ, tùy chọnstatus(Chuỗi): Bộ lọc trạng thái tác vụ, các giá trị tùy chọn: "NOT_START", "SUBMITTED", "QUEUED", "IN_PROGRESS", "FAILURE", "SUCCESS", "UNKNOWN"action(Chuỗi): Bộ lọc loại tác vụ, ví dụ: "textGenerate" (văn bản thành video), "generate" (hình ảnh thành video), v.v.start_timestamp(Số): Dấu thời gian bắt đầu, tùy chọnend_timestamp(Number): Dấu thời gian kết thúc, tùy chọn
🧾 Mô tả trường trả về:
id(Number): ID bản ghitask_id(Chuỗi): ID tác vụplatform(String): Mã nội bộ của nền tảng tác vụ, có thể bỏ quauser_id(Số): ID người dùngquota(Number): Định mức tiêu thụaction(String): Loại tác vụstatus(String): Trạng thái tác vụfail_reason(String): Lý do lỗisubmit_time(Số): Dấu thời gian nộp bàistart_time(Số): Dấu thời gian bắt đầufinish_time(Số): Dấu thời gian hoàn thànhprogress(String): Phần trăm tiến độproperties(Object): Thuộc tính tác vụdata(Object): Dữ liệu kết quả nhiệm vụtotal(Number): Tổng số bản ghi tác vụ trùng khớppage(Number): Số trang trả về hiện tạipage_size(Number): Số lượng bản ghi tác vụ hiển thị trên mỗi trang