TokenLab

Worlds

미디어 에셋 업로드 준비

World Labs 미디어 에셋 업로드 대상을 생성합니다

POST
/v1/worlds/media-assets/prepare-upload

World Labs 미디어 에셋 레코드를 생성하고 이미지 또는 비디오에 대한 업로드 URL을 수신합니다. 바이너리 파일을 upload_info.upload_url로 업로드한 후, 반환된 media_asset.media_asset_id를 source: "media_asset"과 함께 world_prompt에서 참조하세요.

해당 에셋은 이를 생성한 Workspace에서만 사용할 수 있습니다.

{
  "model": "marble-1.1",
  "world_prompt": {
    "type": "image",
    "image_prompt": { "source": "media_asset", "media_asset_id": "<media_asset.media_asset_id>" }
  }
}

이 본문을 월드 생성으로 전송하세요. 다른 Workspace에 속한 media_asset_id는 403 media_asset_not_owned를 반환하며, 알 수 없는 ID는 404 media_asset_not_found를 반환합니다.

요청 본문

file_namestring필수

원본 파일 이름이며, 최대 64자입니다. 예: reference.png.

kindstring필수

미디어 유형: image 또는 video.

extensionstring | null

png, jpg, mp4와 같은 선택적 확장자입니다.

metadataobject | null

에셋과 함께 저장되는 커스텀 메타데이터입니다.

응답

media_assetobject

준비된 미디어 에셋 메타데이터: media_asset_id, file_name, kind, extension, metadata, created_at, updated_at.

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