視頻與素材
列出任務 (Volc 相容)
列出當前組織最近的 Seedance 相容性任務。
概覽
使用 TokenLab Bearer API 金鑰列出已驗證組織的相容性任務。僅列出透過 Volc 相容建立端點所建立的任務。若未提供 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: 建立任務時所傳送的model值。filter.service_tier:default、flex。
回應包含 items(請求的頁面)與 total(所有符合篩選條件的任務)。每個項目皆使用 get-task 的回應格式。若參數不支援或數值超出範圍,將回傳 400。請使用 get 端點來重新整理已知任務的狀態。
範例
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
依服務層級篩選。
可選值
- "default"
- "flex"
回應
application/json
application/json
application/json
application/json