視頻與素材
任務列表（火山相容）
查詢目前組織最近的 Seedance 相容任務。
概覽
使用 TokenLab Bearer API 金鑰列出目前工作區最近的相容任務。不傳 filter.task_ids 時查詢最近七天的任務範圍；指定精確 ID 時直接查詢這些任務。
另見 Seedance 2.0 影片模型 和 影片生成.
回應結構
page_num: 預設1，取值為1–500的整數。page_size: 預設20，取值為1–500的整數。filter.status:queued,running,succeeded,failed,cancelled,expired.filter.task_ids: 查詢多個精確任務 ID 時重複傳入此參數，不要用逗號串接。filter.model: 模型識別碼。filter.service_tier:default,flex.
回應包含篩選結果的 items 和 total，每項均採用取得任務端點的回應結構。已知任務 ID 時，用取得任務端點更新狀態。
範例
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}授權
BearerAuth AuthorizationBearer <token>
API Key 驗證。請在 Dashboard > API > API Keys 建立或管理 API 金鑰。
位置: header
查詢參數
page_num?integer
頁碼。
範圍
1 <= value <= 500預設值
1page_size?integer
頁面大小。
範圍
1 <= value <= 500預設值
20filter.status?string
依任務狀態篩選。
可選值
- "queued"
- "running"
- "succeeded"
- "failed"
- "cancelled"
- "expired"
filter.task_ids?array<string>
精確任務 ID。若有多個 ID 請重複 filter.task_ids。
filter.model?string
依模型識別碼篩選。
filter.service_tier?string
依服務層級篩選。
回應
application/json
application/json
application/json
application/json