ビデオと素材
タスク一覧の取得 (Volc互換)
現在の組織における最近のSeedance互換タスクを一覧表示します。
概要
TokenLab Bearer APIキーを使用して、認証された組織の互換性タスクを一覧表示します。Volc互換の作成エンドポイントを通じて作成されたタスクのみがリストされます。filter.task_idsを指定しない場合、過去7日間のタスクが対象となります。正確な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キー認証。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