Worlds
미디어 자산 업로드 준비
World Labs 미디어 자산 업로드 대상을 만듭니다
World Labs 미디어 자산 레코드를 만들고 이미지 또는 비디오 업로드 URL을 받습니다. 바이너리 파일을 upload_info.upload_url에 업로드한 뒤 world_prompt에서 source: "media_asset"와 반환된 media_asset.media_asset_id를 참조할 수 있습니다.
TokenLab은 자산 소유 조직을 기록합니다. 같은 조직만 이 미디어 자산을 조회하거나 world 생성에 사용할 수 있습니다.
요청 본문
file_namestring필수
원본 파일 이름, 최대 64자.
kindstring필수
미디어 유형: image 또는 video.
extensionstring | null
선택 확장자. 예: png, jpg, mp4.
metadataobject | null
상위 미디어 자산에 저장할 선택 메타데이터 객체.
응답
media_assetobject
준비된 World Labs 미디어 자산 메타데이터.
upload_info.upload_urlstring
바이너리 파일을 업로드할 상위 서명 URL.
upload_info.upload_methodstring
반환된 경우, 바이너리 파일을 upload_info.upload_url에 업로드할 때 사용할 HTTP 메서드입니다.
upload_info.required_headersobject
반환된 경우, 바이너리 업로드에 포함해야 할 헤더입니다.
요청
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"
}'{ "media_asset": { "created_at": "2019-08-24T14:15:22Z", "file_name": "string", "kind": "image", "media_asset_id": "string", "extension": "string", "metadata": {}, "updated_at": "2019-08-24T14:15:22Z" }, "upload_info": { "upload_method": "string", "upload_url": "http://example.com", "curl_example": "string", "required_headers": { "property1": "string", "property2": "string" } }}인증
BearerAuth AuthorizationBearer <token>
API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.
위치: header
요청 본문
application/json
응답
application/json
application/json