TokenLab

視頻與素材

列出任務 (Volc 相容)

列出當前組織最近的 Seedance 相容性任務。

GET
/api/v3/contents/generations/tasks

概覽

使用 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
預設值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