자산 그룹 생성

가용성

이 페이지는 Modelflare 자산 관리 경로를 문서화합니다. 호출에는 유효한 스마트 API 키 또는 미디어 그룹 API 키, 사용 가능한 미디어 채널 및 필수 권한이 필요합니다.

엔드포인트

POST https://modelflare.dev/volc/asset/CreateAssetGroup

인증

Modelflare API 키를 사용하세요.

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

생성, 업데이트 및 삭제 요청과 함께 Idempotency-Key을 보냅니다. 동일한 사용자에 대해 동일한 키를 다시 시도하면 변형을 반복하지 않고 저장된 응답이 재생됩니다.

요청

Seedance 워크플로에서 사용되는 이미지, 비디오 및 오디오 자산에 대한 그룹을 만듭니다.

필드	유형	필수	설명	예시
`Name`	`string`	예	자산 그룹의 이름입니다.	`my-project-assets`
`model`	`string`	아니요	청구 모델. 기본값은 `volc-asset`입니다.	`volc-asset`

JSON 예:

{
  "Name": "my-project-assets",
  "model": "volc-asset"
}

cURL 예:

curl --request POST https://modelflare.dev/volc/asset/CreateAssetGroup \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "Name": "my-project-assets",
  "model": "volc-asset"
}'

응답

그룹이 생성되었습니다.

필드	유형	필수	설명	예시
`Id`	`string`	예	새 자산 그룹 ID입니다.	`group-20260320141746-zsf6b`

응답 예시:

{
  "Id": "group-20260320120601-hsw4s"
}

오류

상태	의미
`400`	요청이 잘못되었습니다.
`401`	API 키가 누락되었거나 승인되지 않았습니다.

오류 본문 예(반환된 경우):

{
  "error": {
    "code": "invalid_request",
    "message": "Request validation failed."
  }
}

이미지, 비디오 및 오디오 생성은 비동기식입니다. 자산 ID를 받은 후 GetAsset을 호출하고 상태가 Active인 경우에만 asset://<ID> 참조를 사용하십시오.