자산 나열

가용성

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

엔드포인트

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

인증

Modelflare API 키를 사용하세요.

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

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

요청

선택적 이름, 그룹 및 그룹 유형 필터를 사용하여 자산을 나열합니다. Seedance 요청에 ID를 사용하기 전에 Status: Active을 기다리십시오.

필드	유형	필수	설명	예시
`model`	`string`	예	청구 모델. 기본값은 `volc-asset`입니다.	`volc-asset`
`Filter.Name`	`string`	아니요	퍼지 자산 이름 필터.	`character`
`Filter.GroupIds`	`string[]`	아니요	그룹 ID로 필터링합니다.	`["group-20260320141746-zsf6b"]`
`Filter.GroupType`	`AIGC`	`LivenessFace`	아니요	그룹 유형별로 필터링합니다.
`PageNumber`	`integer`	아니요	페이지 번호. 기본값은 `1`입니다.	`1`
`PageSize`	`integer`	아니요	페이지당 항목 수입니다. 기본값은 `10`입니다.	`10`

JSON 예:

{
  "model": "volc-asset",
  "Filter": {
    "Name": "character",
    "GroupIds": [
      "group-20260320141746-zsf6b"
    ],
    "GroupType": "AIGC"
  },
  "PageNumber": 1,
  "PageSize": 10
}

cURL 예:

curl --request POST https://modelflare.dev/volc/asset/ListAssets \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "volc-asset",
  "Filter": {
    "Name": "character",
    "GroupIds": [
      "group-20260320141746-zsf6b"
    ],
    "GroupType": "AIGC"
  },
  "PageNumber": 1,
  "PageSize": 10
}'

응답

요청이 성공했습니다.

필드	유형	필수	설명	예시
`Items[]`	`object[]`	아니요	ID, 유형, 그룹, 상태, 프로젝트 및 타임스탬프가 포함된 자산 개체입니다.	`{ Id, Name, AssetType, GroupId, Status, ... }`
`Items[].Id / Name`	`string`	아니요	자산 ID 및 표시 이름.	`asset-20260528140922-d9646 / character-reference`
`Items[].AssetType / GroupId`	`string`	아니요	자산 유형 및 소유 그룹.	`Image / group-20260320141746-zsf6b`
`Items[].Status / ProjectName`	`string`	아니요	처리 상태 및 프로젝트 이름입니다.	`Active / default`
`Items[].CreateTime / UpdateTime`	`string`	아니요	ISO 8601 생성 및 업데이트 타임스탬프.	`2026-03-20T14:25:01Z`
`Items[].URL`	`string`	아니요	임시 파일 URL입니다. 문서화된 수명은 12시간입니다. 생성 요청에는 `asset://<ID>`을 사용하십시오.	`https://example.com/temporary-asset`
`Items[].Error`	`object`	아니요	`Status`가 `Failed`일 때 `Code` 및 `Message` 처리 오류입니다.	`{ Code, Message }`
`PageNumber`	`integer`	아니요	반환된 페이지 번호입니다.	`1`
`PageSize`	`integer`	아니요	반환된 페이지 크기입니다.	`10`
`TotalCount`	`integer`	아니요	일치하는 총 자산입니다.	`2`

응답 예시:

{
  "Items": [
    {
      "Id": "asset-20260528140922-d9646",
      "Name": "character-reference",
      "AssetType": "Image",
      "GroupId": "group-20260320141746-zsf6b",
      "Status": "Active",
      "ProjectName": "default"
    }
  ],
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 1
}

오류

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

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

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

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