TokenLab

Worlds

Chuẩn bị tải lên media asset

Tạo đích tải lên cho media asset World Labs

POST
/v1/worlds/media-assets/prepare-upload

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_namestringbắt buộc

Tên tệp gốc, tối đa 64 ký tự.

kindstringbắt buộc

Loại media: image hoặc video.

extensionstring | null

Đuôi tệp tùy chọn như png, jpg hoặc mp4.

metadataobject | null

Đối tượng metadata tùy chọn lưu cùng media asset upstream.

Phản hồi

media_assetobject

Metadata của media asset World Labs đã chuẩn bị.

upload_info.upload_urlstring

URL upstream đã ký để tải tệp nhị phân lên.

upload_info.upload_methodstring

Phương thức HTTP để tải tệp nhị phân lên upload_info.upload_url, nếu được trả về.

upload_info.required_headersobject

Các header cần gửi cùng tệp nhị phân, nếu đượ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
AuthorizationBearer <token>

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