Worlds

Siapkan upload aset media

Membuat target upload untuk aset media World Labs

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

Buat catatan aset media World Labs dan dapatkan URL upload untuk gambar atau video. Upload file biner ke upload_info.upload_url, lalu rujuk media_asset.media_asset_id dari world_prompt dengan source: "media_asset".

TokenLab mencatat pemilik aset. Hanya organisasi yang sama yang dapat mengambil atau memakai aset media ini untuk generasi World.

Body permintaan

file_namestringwajib

Nama file asli, hingga 64 karakter.

kindstringwajib

Jenis media: image atau video.

extensionstring | null

Ekstensi opsional seperti png, jpg, atau mp4.

metadataobject | null

Objek metadata opsional yang disimpan bersama aset media upstream.

Respons

media_assetobject

Metadata aset media World Labs yang disiapkan.

upload_info.upload_urlstring

URL upstream bertanda tangan untuk mengupload file biner.

upload_info.upload_methodstring

Metode HTTP untuk mengunggah file biner ke upload_info.upload_url, jika dikembalikan.

upload_info.required_headersobject

Header yang perlu disertakan saat mengunggah file biner, jika dikembalikan.

Permintaan

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"    }  }}

Otorisasi

BearerAuth
AuthorizationBearer <token>

Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.

Lokasi: header

Body permintaan

application/json

Respons

application/json

application/json