准备媒体资产上传

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

获取视频状态获取媒体资产

​请求体

​响应

请求体

响应