비디오 및 자료
머티리얼 에셋 목록 조회
현재 조직이 소유한 Seedance 머티리얼을 나열합니다.
조직 및 프로젝트 내의 머티리얼을 나열합니다. library_type, group_id 또는 status(PROCESSING, ACTIVE, FAILED, DELETED)를 기준으로 필터링할 수 있습니다. page_size는 1~100까지 설정 가능하며(기본값 20), 다음 페이지를 읽으려면 응답에서 받은 next_page_token을 page_token으로 전달하십시오.
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,
"updated_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기본값
20page_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