TokenLab
API キーを取得
ドキュメントAPIリファレンス連携

Worlds

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

World Labs メディアアセットのアップロード先を作成します

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

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

マテリアルアセットの削除

前へ

メディアアセットを取得

次へ