TokenLab
Lấy khóa API
Tài liệuTham chiếu APITích hợp

Video & tư liệu

Danh sách tác vụ (tương thích Volc)

Liệt kê tác vụ tương thích Seedance gần đây trong tổ chức hiện tại.

GET
/api/v3/contents/generations/tasks

Tổng quan

Liệt kê tác vụ tương thích gần đây trong Workspace đã xác thực bằng TokenLab Bearer API key. Không có filter.task_ids thì truy vấn bảy ngày gần nhất; cung cấp ID chính xác sẽ truy vấn trực tiếp các tác vụ đó.

Xem thêm Mô hình video Seedance 2.0 và Tạo video.

Dạng phản hồi

  • page_num: mặc định 1, số nguyên từ 1 đến 500.
  • page_size: mặc định 20, số nguyên từ 1 đến 500.
  • filter.status: queued, running, succeeded, failed, cancelled, expired.
  • filter.task_ids: Lặp lại tham số để gửi nhiều ID tác vụ chính xác. Không nối bằng dấu phẩy.
  • filter.model: Định danh mô hình.
  • filter.service_tier: default, flex.

Phản hồi chứa items và total cho kết quả đã lọc. Mỗi phần tử dùng cấu trúc phản hồi lấy tác vụ. Dùng endpoint lấy tác vụ để cập nhật trạng thái của tác vụ đã biết.

Ví dụ

curl "https://api.tokenlab.sh/api/v3/contents/generations/tasks?page_num=1&page_size=20&filter.status=succeeded" \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"
curl "https://api.tokenlab.sh/api/v3/contents/generations/tasks?filter.task_ids=cgt-20260102030405-a1b2c" \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"
curl -X GET "https://example.com/api/v3/contents/generations/tasks"
{  "items": [    {      "id": "string",      "model": "string",      "status": "queued",      "content": {        "video_url": "http://example.com",        "last_frame_url": "http://example.com"      },      "seed": 0,      "resolution": "string",      "ratio": "string",      "duration": "string",      "frames": 0,      "framespersecond": 0,      "generate_audio": true,      "tools": {        "type": "web_search"      },      "safety_identifier": "string",      "draft": true,      "draft_task_id": "string",      "service_tier": "string",      "execution_expires_after": 0,      "usage": {        "completion_tokens": 0,        "total_tokens": 0,        "tool_usage": {          "web_search": 0        }      },      "error": {        "code": "string",        "message": "string"      },      "created_at": 0,      "updated_at": 0    }  ],  "total": 0}

Xác thực

BearerAuth
AuthorizationBearer <token>

Xác thực bằng Khóa API. Tạo hoặc quản lý khóa API trong Dashboard > API > API Keys.

Vị trí: header

Tham số truy vấn

page_num?integer

Số trang.

Phạm vi1 <= value <= 500
mặc định1
page_size?integer

Kích thước trang.

Phạm vi1 <= value <= 500
mặc định20
filter.status?string

Lọc theo trạng thái tác vụ.

Giá trị hợp lệ

  • "queued"
  • "running"
  • "succeeded"
  • "failed"
  • "cancelled"
  • "expired"
filter.task_ids?array<string>

ID tác vụ chính xác. Lặp lại filter.task_ids cho nhiều ID.

filter.model?string

Lọc theo định danh mô hình.

filter.service_tier?string

Lọc theo cấp dịch vụ.

Phản hồi

application/json

application/json

application/json

application/json

Lấy Task (Tương thích Volc)

Trước

Hủy tác vụ (tương thích Volc)

Tiếp