Worlds

Medya varlığı yüklemeyi hazırla

World Labs medya varlığı için yükleme hedefi oluşturur

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

World Labs medya varlığı kaydı oluşturun ve görüntü ya da video için yükleme URL’si alın. İkili dosyayı upload_info.upload_url adresine yükledikten sonra world_prompt içinde source: "media_asset" ile dönen media_asset.media_asset_id değerini kullanın.

TokenLab varlığın sahibini kaydeder. Bu medya varlığını yalnızca aynı organizasyon alabilir veya World üretiminde kullanabilir.

İstek gövdesi

file_namestringzorunlu

Orijinal dosya adı, en fazla 64 karakter.

kindstringzorunlu

Medya türü: image veya video.

extensionstring | null

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

metadataobject | null

Upstream medya varlığıyla saklanan isteğe bağlı metadata nesnesi.

Yanıt

media_assetobject

Hazırlanan World Labs medya varlığı metadatası.

upload_info.upload_urlstring

İkili dosyanın yükleneceği imzalı upstream URL.

upload_info.upload_methodstring

Döndürülürse, ikili dosyayı upload_info.upload_url adresine yüklemek için kullanılacak HTTP yöntemi.

upload_info.required_headersobject

Döndürülürse, ikili dosya yüklemesinde gönderilmesi gereken başlıklar.

İ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