準備媒體資產上傳

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

取得影片狀態取得媒體資產

​請求體

​回應

請求體

回應