TokenLab

비디오 및 자료

머티리얼 에셋 목록 조회

현재 조직이 소유한 Seedance 머티리얼 에셋 목록을 조회합니다.

GET
/v1/videos/assets

인증된 조직이 소유한 머티리얼 에셋 목록을 조회합니다. 특정 생성 워크플로우를 위한 에셋을 찾아야 할 경우 library_type, group_id 또는 status를 사용하여 필터링할 수 있습니다.

status가 ACTIVE인 에셋만 사용하십시오. 비디오를 생성할 때는 반환된 TokenLab 소재 에셋 id를 사용하십시오.

project_name은 인증된 조직 내 리소스를 분리합니다. 기본값은 default이며 관련 그룹과 소재에는 대소문자를 구분하는 동일한 값을 사용하세요. POST/PUT은 JSON 본문에, GET/DELETE는 쿼리 매개변수에 지정합니다.

요청 예시

curl "https://api.tokenlab.sh/v1/videos/assets?library_type=aigc_avatar&group_id=group-20260720123456-vrt01&page_size=20&project_name=default" \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"

응답 예시

{
  "assets": [
    {
      "id": "asset-20260720123456-qn7wr",
      "object": "seedance.material_asset",
      "project_name": "default",
      "group_id": "group-20260720123456-vrt01",
      "library_type": "aigc_avatar",
      "asset_name": "Front view",
      "asset_type": "Image",
      "status": "ACTIVE",
      "ready": true,
      "created_at": 1782998400000
    }
  ],
  "next_page_token": null
}
curl -X GET "https://example.com/v1/videos/assets"
{  "assets": [    {      "id": "asset-20260720123456-qn7wr",      "object": "seedance.material_asset",      "group_id": "group-20260720123456-vrt01",      "library_type": "aigc_avatar",      "asset_name": "Front view",      "asset_type": "Image",      "status": "ACTIVE",      "ready": true,      "error_message": null,      "metadata": null,      "created_at": 1782998400000    }  ],  "next_page_token": null}

인증

BearerAuth
AuthorizationBearer <token>

API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.

위치: header

쿼리 매개변수

page_size?integer
범위1 <= value <= 100
기본값20
page_token?string
group_id?string

TokenLab 자료 에셋 그룹 ID별 필터링.

status?string

허용 값

  • "PROCESSING"
  • "ACTIVE"
  • "FAILED"
  • "DELETED"
library_type?string

자료 라이브러리 클래스별 필터링.

허용 값

  • "aigc_avatar"
  • "liveness_face"
project_name?string

자료 리소스에 대한 프로젝트 범위.

길이1 <= length <= 128
기본값"default"

응답

application/json

application/json

application/json

application/json