Saltar para o conteúdo principal
Crie um registro de mídia World Labs e receba uma URL de upload para imagem ou vídeo. Envie o binário para upload_info.upload_url e depois referencie media_asset.media_asset_id no world_prompt com source: "media_asset". TokenLab registra o proprietário da mídia. Somente a mesma organização pode buscar ou usar essa mídia em uma geração de World.

​
Corpo da requisição

​
file_name
string
obrigatório
Nome de arquivo original, até 64 caracteres.
​
kind
string
obrigatório
Tipo de mídia: image ou video.
​
extension
string
Extensão opcional como png, jpg ou mp4.
​
metadata
object
Objeto opcional de metadados salvo com a mídia upstream.

​
Resposta

​
media_asset
object
Metadados da mídia World Labs preparada.
​
upload_info.upload_url
string
URL upstream assinada para envio do arquivo binário.
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"
  }'