에셋 다운로드 메타데이터 조회
GET /assets/{asset_id}의 인증, 필드, 응답, 오류, 안전한 운영을 원본에서 생성한 레퍼런스입니다.
이 페이지의 내용
작업
GET /assets/{asset_id}
operationId: get_asset_v1_assets__asset_id__get
소유 에셋 정보와 갱신된 단기 서명 URL을 반환합니다. 만료 URL 대신 에셋 ID를 저장하세요. 저장소 리디렉션을 포함한 다운로드에 API 인증 정보를 붙이지 마세요. 소유권·보관 정책은 계속 적용됩니다.
인증 및 부수 효과
서버 측 Bearer API 키를 사용하세요. 필요한 권한: animations:read
유료 생성을 시작하지 않습니다. 다른 상태 변경은 위 설명을 확인하세요.
매개변수
| 매개변수 | 위치 | 유형 | 필수 | 제약 / 기본값 | 설명 |
|---|---|---|---|---|---|
asset_id |
path |
string |
예 | format: uuid |
Owned public resource UUID; task, asset, and file IDs are not interchangeable. |
응답
| HTTP | 본문 | 설명 |
|---|---|---|
200 |
AssetResponse | Successful public response. Example values are illustrative. |
400 |
APIErrorEnvelope | Invalid input; correct the request before retrying. |
401 |
APIErrorEnvelope | Missing, expired, or revoked API key. |
403 |
APIErrorEnvelope | Account eligibility, account status, or key scope does not allow this operation. |
404 |
APIErrorEnvelope | Resource is unavailable, not owned, or its signature is invalid/expired. |
429 |
APIErrorEnvelope | Account-wide rate or queue limit; wait for Retry-After. |
500 |
APIErrorEnvelope | Internal failure; preserve the task/key and retry only when marked retryable. |
503 |
APIErrorEnvelope | Service/provider unavailable; retry only when error.retryable is true. |
응답 헤더
| HTTP | 헤더 | 유형 | 설명 |
|---|---|---|---|
429 |
Retry-After |
integer |
Suggested wait in seconds; respect the server value and an overall deadline. |
503 |
Retry-After |
integer |
Suggested wait in seconds; respect the server value and an overall deadline. |
응답 예제
{
"byte_size": 1024,
"created_at": "2026-08-30T00:00:00Z",
"download_expires_at": "2026-08-30T01:00:00Z",
"download_url": "https://downloads.example.invalid/illustrative-asset",
"format": "clip_video",
"id": "00000000-0000-4000-8000-000000000003",
"media": {
"duration_seconds": 5.04,
"fps": 25,
"frame_count": 126,
"height": 512,
"width": 512
},
"mime_type": "video/mp4",
"object": "asset"
}
관련 가이드
이 문서가 도움이 되었나요?
검색어, 코드 또는 자유 입력 텍스트는 수집하지 않습니다. 이 설정은 문서 상호작용 이벤트만 제어합니다. 개인정보 처리방침