자산 가져오기

가용성

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

엔드포인트

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

인증

Modelflare API 키를 사용하세요.

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

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

요청

ID별로 하나의 자산을 읽습니다. Status이 Active 또는 Failed가 될 때까지 비동기 업로드를 폴링하려면 이 경로를 사용합니다.

필드	유형	필수	설명	예시
`Id`	`string`	예	쿼리할 자산 ID입니다.	`asset-20260528140922-d9646`

JSON 예:

{
  "Id": "asset-20260528140922-d9646"
}

cURL 예:

curl --request POST https://modelflare.dev/volc/asset/GetAsset \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "Id": "asset-20260528140922-d9646"
}'

응답

요청이 성공했습니다.

필드	유형	필수	설명	예시
`Id`	`string`	예	자산 ID.	`asset-20260528140922-d9646`
`Name`	`string`	아니요	자산 이름.	`character-reference`
`URL`	`string`	아니요	임시 파일 URL입니다. 문서화된 수명은 12시간입니다. 이를 생성 참조로 유지하지 마십시오.	`https://example.com/temporary-asset`
`AssetType`	`Image`	`Video`	`Audio`	아니요
`GroupId`	`string`	아니요	소유 그룹 ID입니다.	`group-20260320141746-zsf6b`
`Status`	`Processing`	`Active`	`Failed`	아니요
`ProjectName`	`string`	아니요	프로젝트 이름.	`default`
`CreateTime / UpdateTime`	`string`	아니요	ISO 8601 타임스탬프.	`2026-05-28T06:09:31Z`

응답 예시:

{
  "Id": "asset-20260528140922-d9646",
  "Name": "character-reference",
  "AssetType": "Image",
  "GroupId": "group-20260320141746-zsf6b",
  "Status": "Active",
  "ProjectName": "default",
  "CreateTime": "2026-05-28T06:09:22Z",
  "UpdateTime": "2026-05-28T06:09:31Z"
}

오류

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

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

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

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