Worlds

Medya Varlığı Yüklemesini Hazırla

Bir World Labs medya varlığı yükleme hedefi oluşturur

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

Bir World Labs medya varlığı kaydı oluşturun ve bir görsel veya video için bir yükleme URL'i alın. Binary dosyayı upload_info.upload_url adresine yükleyin, ardından source: "media_asset" ile birlikte world_prompt üzerinden döndürülen media_asset.media_asset_id değerine referans verin.

Varlık yalnızca onu oluşturan Workspace içinde kullanılabilir.

{
  "model": "marble-1.1",
  "world_prompt": {
    "type": "image",
    "image_prompt": { "source": "media_asset", "media_asset_id": "<media_asset.media_asset_id>" }
  }
}

Bu gövdeyi Dünya Oluştur uç noktasına gönderin. Başka bir Workspace'e ait bir media_asset_id, 403 media_asset_not_owned hatası döndürür; bilinmeyen bir kimlik ise 404 media_asset_not_found hatası döndürür.

İstek Gövdesi

file_namestringzorunlu

En fazla 64 karakter uzunluğunda orijinal dosya adı, örneğin reference.png.

kindstringzorunlu

Medya türü: image veya video.

extensionstring | null

png, jpg veya mp4 gibi isteğe bağlı uzantı.

metadataobject | null

Varlıkla birlikte saklanan özel meta veriler.

Yanıt

media_assetobject

Hazırlanan medya varlığı meta verileri: media_asset_id, file_name, kind, extension, metadata, created_at ve updated_at.

upload_info.upload_urlstring

Dosyayı yüklemek için imzalanmış URL.

upload_info.upload_methodstring

Döndürüldüğünde, binary dosyayı upload_info.upload_url adresine yüklerken kullanılacak HTTP yöntemi.

upload_info.required_headersobject

Döndürüldüğünde, binary yüklemeye dahil edilecek başlıklar (headers).

İstek

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

Yetkilendirme

BearerAuth
AuthorizationBearer <token>

API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.

Konum: header

İstek gövdesi

application/json

Yanıt

application/json

application/json