Worlds

Medien-Asset-Upload vorbereiten

Erstellt ein Upload-Ziel für ein World Labs Medien-Asset

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

Erstelle einen World Labs Medien-Asset-Datensatz und erhalte eine Upload-URL für ein Bild oder Video. Lade die Binärdatei nach upload_info.upload_url hoch und referenziere danach media_asset.media_asset_id im world_prompt mit source: "media_asset".

TokenLab speichert den Besitzer des Assets. Nur dieselbe Organisation kann dieses Medien-Asset abrufen oder für World-Generierung verwenden.

Anfragekörper

file_namestringerforderlich

Ursprünglicher Dateiname, bis zu 64 Zeichen.

kindstringerforderlich

Medientyp: image oder video.

extensionstring | null

Optionale Erweiterung wie png, jpg oder mp4.

metadataobject | null

Optionales Metadatenobjekt für das Upstream-Medien-Asset.

Antwort

media_assetobject

Metadaten des vorbereiteten World Labs Medien-Assets.

upload_info.upload_urlstring

Signierte Upstream-URL für den Binär-Upload.

upload_info.upload_methodstring

HTTP-Methode für den Binär-Upload an upload_info.upload_url, sofern zurückgegeben.

upload_info.required_headersobject

Header für den Binär-Upload, sofern zurückgegeben.

Anfrage

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

Autorisierung

BearerAuth
AuthorizationBearer <token>

API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.

Ort: header

Anfragekörper

application/json

Antwort

application/json

application/json