TokenLab

Video & tư liệu

Liệt kê tác vụ (Tương thích Volc)

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

GET
/api/v3/contents/generations/tasks

Tổng quan

Liệt kê các tác vụ tương thích của tổ chức đã xác thực bằng cách sử dụng khóa API Bearer của TokenLab. Chỉ các tác vụ được tạo thông qua endpoint tạo tương thích với Volc mới được liệt kê. Nếu không có filter.task_ids, kết quả sẽ bao gồm các tác vụ từ bảy ngày qua; việc cung cấp các 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.

Liệt kê và Bộ lọc

  • 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ố này cho nhiều ID tác vụ chính xác; không nối chúng bằng dấu phẩy.
  • filter.model: Giá trị model được gửi khi tác vụ được tạo.
  • filter.service_tier: default, flex.

Phản hồi chứa items (trang được yêu cầu) và total (tất cả các tác vụ khớp với bộ lọc). Mỗi mục sử dụng định dạng phản hồi get-task. Một tham số không được hỗ trợ hoặc giá trị nằm ngoài phạm vi sẽ trả về 400. Sử dụng endpoint get để làm mới trạng thái của một 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 giá trị model được gửi khi task được tạo.

filter.service_tier?string

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

Giá trị hợp lệ

  • "default"
  • "flex"

Phản hồi

application/json

application/json

application/json

application/json