Worlds
準備媒體資產上傳
建立 World Labs 媒體資產上傳目標
建立 World Labs 媒體資產記錄並接收圖片或影片的上傳 URL。將二進位檔案上傳至 upload_info.upload_url,然後在 world_prompt 中以 source: "media_asset" 引用返回的 media_asset.media_asset_id。
該資產僅在建立它的 Workspace 中可用。
{
"model": "marble-1.1",
"world_prompt": {
"type": "image",
"image_prompt": { "source": "media_asset", "media_asset_id": "<media_asset.media_asset_id>" }
}
}將此請求主體傳送至 建立世界。屬於另一個 Workspace 的 media_asset_id 會返回 403 media_asset_not_owned;未知的識別碼則會返回 404 media_asset_not_found。
請求主體
原始檔案名稱,最多 64 個字元,例如 reference.png。
媒體類型:image 或 video。
選填的副檔名,例如 png、jpg 或 mp4。
與資產一同儲存的自訂中繼資料。
回應
準備完成的媒體資產中繼資料:media_asset_id、file_name、kind、extension、metadata、created_at 與 updated_at。
用於上傳檔案的簽署 URL。
當返回時,上傳二進位檔案至 upload_info.upload_url 所使用的 HTTP 方法。
當返回時,二進位上傳需包含的標頭。
請求
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 API Key 驗證。請在 Dashboard > API > API Keys 建立或管理 API 金鑰。
位置: header
請求主體
application/json
回應
application/json
application/json