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