Chuyển đến nội dung chính
Tạo bản ghi media asset World Labs và nhận URL tải lên cho ảnh hoặc video. Tải tệp nhị phân lên upload_info.upload_url, sau đó tham chiếu media_asset.media_asset_id trong world_prompt với source: "media_asset". TokenLab ghi nhận chủ sở hữu asset. Chỉ cùng tổ chức mới có thể lấy hoặc dùng media asset này trong tạo World.

​
Thân yêu cầu

​
file_name
string
bắt buộc
Tên tệp gốc, tối đa 64 ký tự.
​
kind
string
bắt buộc
Loại media: image hoặc video.
​
extension
string
Đuôi tệp tùy chọn như png, jpg hoặc mp4.
​
metadata
object
Đối tượng metadata tùy chọn lưu cùng media asset upstream.

​
Phản hồi

​
media_asset
object
Metadata của media asset World Labs đã chuẩn bị.
​
upload_info.upload_url
string
URL upstream đã ký để tải tệp nhị phân lên.
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"
  }'