ビデオと素材

タスク一覧の取得 (Volc互換)

現在の組織における最近のSeedance互換タスクを一覧表示します。

GET
/api/v3/contents/generations/tasks

概要

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
デフォルト1
page_size?integer

ページサイズ。

範囲1 <= value <= 500
デフォルト20
filter.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