TokenLab

비디오 및 자료

작업 목록 조회 (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