Worlds
准备 World 素材上传
获取 World 图片或视频素材的上传地址
创建 World 素材并获取上传地址。把文件上传到 upload_info.upload_url 后，在 world_prompt 中使用返回的 media_asset.media_asset_id。
素材只对当前工作区可见，也只能在这个工作区中用于 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 Key 身份验证。在 Dashboard > API > API Keys 中创建或管理 API Key。
位置: header
请求体
application/json
响应
application/json
application/json