Saltar al contenido principal
Crea un registro de medio de World Labs y recibe una URL de subida para una imagen o video. Sube el binario a upload_info.upload_url y luego referencia media_asset.media_asset_id desde world_prompt con source: "media_asset". TokenLab registra el propietario del medio. Solo la misma organización puede recuperar o usar este medio en la generación de Worlds.

​
Cuerpo de la solicitud

​
file_name
string
requerido
Nombre de archivo original, hasta 64 caracteres.
​
kind
string
requerido
Tipo de medio: image o video.
​
extension
string
Extensión opcional como png, jpg o mp4.
​
metadata
object
Objeto opcional de metadatos guardado con el medio upstream.

​
Respuesta

​
media_asset
object
Metadatos del medio de World Labs preparado.
​
upload_info.upload_url
string
URL upstream firmada donde subir el archivo binario.
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"
  }'