メディアアセットアップロードを準備

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"
  }'

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"
  }'

ビデオのステータスを取得メディアアセットを取得

​リクエストボディ

​レスポンス

リクエストボディ

レスポンス