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.
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 định1, số nguyên từ1đến500.page_size: mặc định20, số nguyên từ1đến500.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 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
Số trang.
1 <= value <= 5001Kích thước trang.
1 <= value <= 50020Lọc theo trạng thái tác vụ.
Giá trị hợp lệ
- "queued"
- "running"
- "succeeded"
- "failed"
- "cancelled"
- "expired"
ID tác vụ chính xác. Lặp lại filter.task_ids cho nhiều ID.
Lọc theo giá trị model được gửi khi task được tạo.
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