TokenLab
API 키 받기
문서API 레퍼런스통합

비디오 및 자료

머티리얼 에셋 가져오기

TokenLab 머티리얼 에셋 ID를 사용하여 Seedance 머티리얼 에셋 하나를 조회합니다.

GET
/v1/videos/assets/{assetId}

머티리얼 에셋 하나를 조회하고 처리 상태를 확인합니다. 에셋은 ready가 true이고 status가 ACTIVE인 경우에만 비디오 생성에 사용할 수 있습니다.

비디오 생성 시 Seedance material asset not found or not accessible 오류가 반환되면, group_id가 아닌 해당 머티리얼 에셋의 id를 전달했는지 확인하십시오.

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

요청 예시

curl "https://api.tokenlab.sh/v1/videos/assets/asset-20260720123456-qn7wr?project_name=default" \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"

응답 예시

{
  "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,
  "error_message": null,
  "metadata": null,
  "created_at": 1782998400000
}
curl -X GET "https://example.com/v1/videos/assets/asset-20260720123456-qn7wr"
{  "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}

인증

BearerAuth
AuthorizationBearer <token>

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

위치: header

경로 매개변수

assetId*string

쿼리 매개변수

project_name?string

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

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

응답

application/json

application/json

application/json

application/json

application/json

머티리얼 에셋 목록 조회

이전

머티리얼 에셋 업데이트

다음