Saltar para o conteúdo principal
Gere mundos 3D exploráveis com World Labs Marble. Esta API é assíncrona: respostas de criação retornam uma identidade de tarefa e uma poll_url para verificar status. Os modelos suportados são marble-1.0, marble-1.1 e marble-1.1-plus. A World Labs documenta marble-1.0-draft, mas o TokenLab ainda não expõe geração draft neste endpoint.

​
Corpo da requisição

​
model
string
padrão:"marble-1.0"
Modelo Marble a usar: marble-1.0, marble-1.1 ou marble-1.1-plus.
​
prompt
string
Prompt de texto para geração somente texto ou como guia com entradas de imagem/vídeo.
​
world_prompt
object
Objeto nativo World Labs world_prompt para chamadas avançadas. Tipos suportados: text, image, multi-image e video.
​
image
string
Prompt de imagem em Base64 ou data URL.
​
image_url
string
Prompt por URL de imagem.
​
images
array
Vários prompts de imagem para geração multi-image rápida. Forneça até 4 imagens. Para o modo de reconstrução nativo da World Labs, envie world_prompt.type="multi-image" com reconstruct_images: true e até 8 imagens.
​
video_url
string
Prompt por URL de vídeo.
​
is_pano
boolean | string
Para entradas de imagem, use true para panorama existente, false para imagem única normal, ou auto.
​
seed
integer
Seed opcional de 0 a 4294967295.
​
display_name
string
Nome de exibição opcional para o mundo upstream, até 64 caracteres.
​
tags
array
Tags upstream opcionais. Até 10 tags, cada uma com até 32 caracteres.
​
permission
object
Objeto permission opcional da World Labs.

​
Resposta

​
id
string
ID público da tarefa para polling.
​
task_id
string
Alias do identificador de tarefa assíncrona.
​
operation_id
string
ID de operation upstream da World Labs.
​
poll_url
string
URL de polling preferida para esta tarefa.
​
status
string
Status da tarefa: pending, processing, completed ou failed.
​
world_marble_url
string
URL do mundo Marble gerado quando concluído.
​
glb_url
string
URL GLB da malha collider quando disponível.
​
pano_url
string
URL da imagem panorâmica quando disponível.

​
Preços

A World Labs cobra em credits. O TokenLab pré-deduz o máximo do tipo de requisição e liquida pelo cost.total_credits da operation concluída quando disponível. Requisições Marble padrão chegam a 1.600 credits. marble-1.1-plus chega a 3.100 credits.

​
Escopo

Esses endpoints de gestão cobrem mídias pertencentes ao TokenLab e Worlds gerados concluídos. TokenLab ainda não expõe geração marble-1.0-draft nem ferramentas pano/depth independentes. 
curl -X POST "https://api.tokenlab.sh/v1/worlds/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "marble-1.1",
    "prompt": "Uma cidade costeira tranquila ao pôr do sol com vielas estreitas e luzes quentes"
  }'