Video & materi

Daftar Tugas (Kompatibel dengan Volc)

Mencantumkan tugas kompatibilitas Seedance terbaru untuk organisasi saat ini.

GET
/api/v3/contents/generations/tasks

Gambaran Umum

Mencantumkan tugas kompatibilitas dari organisasi yang terautentikasi menggunakan kunci API Bearer TokenLab. Hanya tugas yang dibuat melalui endpoint pembuatan yang kompatibel dengan Volc yang akan dicantumkan. Tanpa filter.task_ids, hasil mencakup tugas dari tujuh hari terakhir; memberikan ID yang tepat akan melakukan kueri pada tugas-tugas tersebut secara langsung.

Lihat juga Model Video Seedance 2.0 dan Pembuatan Video.

Pencantuman Dan Filter

  • page_num: default 1, integer dari 1 hingga 500.
  • page_size: default 20, integer dari 1 hingga 500.
  • filter.status: queued, running, succeeded, failed, cancelled, expired.
  • filter.task_ids: Ulangi parameter ini untuk beberapa ID tugas yang tepat; jangan menggabungkannya dengan koma.
  • filter.model: Nilai model yang dikirim saat tugas dibuat.
  • filter.service_tier: default, flex.

Respons berisi items (halaman yang diminta) dan total (semua tugas yang cocok dengan filter). Setiap item menggunakan bentuk respons get-task. Parameter yang tidak didukung atau nilai di luar jangkauan akan mengembalikan 400. Gunakan endpoint get untuk menyegarkan status tugas yang diketahui.

Contoh

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}

Otorisasi

BearerAuth
AuthorizationBearer <token>

Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.

Lokasi: header

Parameter query

page_num?integer

Nomor halaman.

Rentang1 <= value <= 500
bawaan1
page_size?integer

Ukuran halaman.

Rentang1 <= value <= 500
bawaan20
filter.status?string

Filter berdasarkan status tugas.

Nilai yang tersedia

  • "queued"
  • "running"
  • "succeeded"
  • "failed"
  • "cancelled"
  • "expired"
filter.task_ids?array<string>

ID tugas yang tepat. Ulangi filter.task_ids untuk beberapa ID.

filter.model?string

Filter berdasarkan nilai model yang dikirim saat tugas dibuat.

filter.service_tier?string

Filter berdasarkan tingkat layanan.

Nilai yang tersedia

  • "default"
  • "flex"

Respons

application/json

application/json

application/json

application/json