메인 콘텐츠로 건너뛰기
World Labs 미디어 자산 레코드를 만들고 이미지 또는 비디오 업로드 URL을 받습니다. 바이너리 파일을 upload_info.upload_url에 업로드한 뒤 world_prompt에서 source: "media_asset"와 반환된 media_asset.media_asset_id를 참조할 수 있습니다. TokenLab은 자산 소유 조직을 기록합니다. 같은 조직만 이 미디어 자산을 조회하거나 world 생성에 사용할 수 있습니다.

​
요청 본문

​
file_name
string
필수
원본 파일 이름, 최대 64자.
​
kind
string
필수
미디어 유형: image 또는 video.
​
extension
string
선택 확장자. 예: png, jpg, mp4.
​
metadata
object
상위 미디어 자산에 저장할 선택 메타데이터 객체.

​
응답

​
media_asset
object
준비된 World Labs 미디어 자산 메타데이터.
​
upload_info.upload_url
string
바이너리 파일을 업로드할 상위 서명 URL.
curl -X POST "https://api.tokenlab.sh/v1/worlds/media-assets/prepare-upload" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "file_name": "reference.png",
    "kind": "image",
    "extension": "png"
  }'