88API88API
User GuideAI ApplicationsAPI ReferenceHelp & Support
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à 1
  • page_size (Number): Số mục trên một trang, mặc định là 20
  • platform (String): Mã nền tảng tác vụ, tùy chọn, thường không cần điền
  • task_id (String): Bộ lọc ID tác vụ, tùy chọn
  • status (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ọn
  • end_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 ghi
  • task_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ỏ qua
  • user_id (Số): ID người dùng
  • quota (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ỗi
  • submit_time (Số): Dấu thời gian nộp bài
  • start_time (Số): Dấu thời gian bắt đầu
  • finish_time (Số): Dấu thời gian hoàn thành
  • progress (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ớp
  • page (Number): Số trang trả về hiện tại
  • page_size (Number): Số lượng bản ghi tác vụ hiển thị trên mỗi trang