Zum Hauptinhalt springen
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.

​
Request Body

​
file_name
string
erforderlich
Ursprünglicher Dateiname, bis zu 64 Zeichen.
​
kind
string
erforderlich
Medientyp: image oder video.
​
extension
string
Optionale Erweiterung wie png, jpg oder mp4.
​
metadata
object
Optionales Metadatenobjekt für das Upstream-Medien-Asset.

​
Response

​
media_asset
object
Metadaten des vorbereiteten World Labs Medien-Assets.
​
upload_info.upload_url
string
Signierte Upstream-URL für den Binär-Upload.
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"
  }'