Worlds
Siapkan Unggahan Aset Media
Membuat target unggahan aset media World Labs
Buat rekaman aset media World Labs dan dapatkan URL unggahan untuk gambar atau video. Unggah file biner ke upload_info.upload_url, lalu referensikan media_asset.media_asset_id yang dikembalikan dari world_prompt dengan source: "media_asset".
Aset ini hanya tersedia di Workspace yang membuatnya.
{
"model": "marble-1.1",
"world_prompt": {
"type": "image",
"image_prompt": { "source": "media_asset", "media_asset_id": "<media_asset.media_asset_id>" }
}
}Kirim body ini ke Buat World. media_asset_id milik Workspace lain akan mengembalikan 403 media_asset_not_owned; yang tidak dikenal akan mengembalikan 404 media_asset_not_found.
Body Permintaan
Nama file asli, hingga 64 karakter, misalnya reference.png.
Jenis media: image atau video.
Ekstensi opsional seperti png, jpg, atau mp4.
Metadata kustom yang disimpan bersama aset.
Respons
Metadata aset media yang telah disiapkan: media_asset_id, file_name, kind, extension, metadata, created_at, dan updated_at.
Signed URL untuk mengunggah file.
Metode HTTP yang digunakan saat mengunggah file biner ke upload_info.upload_url, jika dikembalikan.
Header yang harus disertakan bersama unggahan 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 Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.
Lokasi: header
Body permintaan
application/json
Respons
application/json
application/json