Passer au contenu principal
Créez un enregistrement de média World Labs et recevez une URL d’upload pour une image ou une vidéo. Uploadez le fichier binaire vers upload_info.upload_url, puis référencez media_asset.media_asset_id dans world_prompt avec source: "media_asset". TokenLab enregistre le propriétaire du média. Seule la même organisation peut récupérer ou utiliser ce média dans une génération de World.

​
Corps de requête

​
file_name
string
requis
Nom de fichier d’origine, jusqu’à 64 caractères.
​
kind
string
requis
Type de média: image ou video.
​
extension
string
Extension optionnelle, par exemple png, jpg ou mp4.
​
metadata
object
Objet de métadonnées optionnel stocké avec le média upstream.

​
Réponse

​
media_asset
object
Métadonnées du média World Labs préparé.
​
upload_info.upload_url
string
URL upstream signée où uploader le fichier binaire.
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"
  }'