TokenLab

비디오 및 자료

머티리얼 에셋 그룹 생성

Seedance 가상 아바타 머티리얼 그룹을 생성합니다.

POST
/v1/videos/assets/groups

실제 인물 인증이 필요 없는 가상 아바타, 제품, 스타일 및 기타 재사용 가능한 참조를 위해 library_type: "aigc_avatar" 머티리얼 그룹을 생성합니다. group_name은 선택 사항이며(1~128자), description도 선택 사항입니다(최대 500자). 요청이 성공하면 201을 반환합니다.

이 엔드포인트로는 실제 인물 그룹을 생성할 수 없으며, library_type: "liveness_face" 사용 시 400 오류가 반환됩니다. 실제 인물 그룹은 시각적 검증을 통해 생성하십시오.

project_name은 조직 내 리소스 범위를 지정하며 기본값은 default입니다. 관련 그룹 및 에셋에는 대소문자를 구분하여 동일한 값을 사용하십시오. POST/PUT 요청 시에는 JSON 본문에, GET/DELETE 요청 시에는 쿼리 문자열에 포함하여 전송합니다.

요청 예시

curl https://api.tokenlab.sh/v1/videos/assets/groups \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"library_type":"aigc_avatar","group_name":"Product references","description":"Reusable product shots","project_name":"default"}'

응답 예시

{
  "id": "group-20260720123456-vrt01",
  "object": "seedance.material_asset_group",
  "project_name": "default",
  "library_type": "aigc_avatar",
  "group_name": "Product references",
  "description": "Reusable product shots",
  "status": "ACTIVE",
  "metadata": null,
  "created_at": 1782998400000,
  "updated_at": 1782998400000
}
curl -X POST "https://example.com/v1/videos/assets/groups" \  -H "Content-Type: application/json" \  -d '{    "library_type": "aigc_avatar",    "group_name": "Product references",    "description": "재사용 가능한 제품 샷"  }'
{  "id": "group-20260720123456-vrt01",  "object": "seedance.material_asset_group",  "library_type": "aigc_avatar",  "group_name": "Product references",  "description": "재사용 가능한 제품 샷",  "status": "ACTIVE",  "metadata": null,  "created_at": 1782998400000}

인증

BearerAuth
AuthorizationBearer <token>

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

위치: header

요청 본문

application/json

응답

application/json

application/json

application/json

application/json

application/json

application/json