Worlds
Chuẩn bị tải lên Media Asset
Tạo đích tải lên media asset của World Labs
Tạo một bản ghi media asset của World Labs và nhận URL tải lên cho hình ảnh hoặc video. Tải tệp nhị phân lên upload_info.upload_url, sau đó tham chiếu đến media_asset.media_asset_id được trả về từ world_prompt với source: "media_asset".
Tài nguyên này chỉ khả dụng trong Workspace đã tạo ra nó.
{
"model": "marble-1.1",
"world_prompt": {
"type": "image",
"image_prompt": { "source": "media_asset", "media_asset_id": "<media_asset.media_asset_id>" }
}
}Gửi body này tới Tạo World. Một media_asset_id thuộc về Workspace khác sẽ trả về 403 media_asset_not_owned; một ID không xác định sẽ trả về 404 media_asset_not_found.
Phần thân yêu cầu (Request Body)
Tên tệp gốc, tối đa 64 ký tự, ví dụ reference.png.
Loại media: image hoặc video.
Phần mở rộng tùy chọn như png, jpg, hoặc mp4.
Metadata tùy chỉnh được lưu trữ cùng với tài nguyên.
Phản hồi
Metadata của media asset đã chuẩn bị: media_asset_id, file_name, kind, extension, metadata, created_at, và updated_at.
Signed URL để tải tệp lên.
Phương thức HTTP cần sử dụng khi tải tệp nhị phân lên upload_info.upload_url, khi được trả về.
Các header cần bao gồm khi tải lên tệp nhị phân, khi được trả về.
Yêu cầu
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" } }}Xác thực
BearerAuth Xác thực bằng Khóa API. Tạo hoặc quản lý khóa API trong Dashboard > API > API Keys.
Vị trí: header
Nội dung yêu cầu
application/json
Phản hồi
application/json
application/json