Skip to main content
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

string
padrão:"marble-1.0"
Modelo Marble a usar: marble-1.0, marble-1.1 ou marble-1.1-plus.
string
Prompt de texto para geração somente texto ou como guia com entradas de imagem/vídeo.
object
Objeto nativo World Labs world_prompt para chamadas avançadas. Tipos suportados: text, image, multi-image e video.
string
Prompt de imagem em Base64 ou data URL.
string
Prompt por URL de imagem.
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.
string
Prompt por URL de vídeo.
boolean | string
Para entradas de imagem, use true para panorama existente, false para imagem única normal, ou auto.
integer
Seed opcional de 0 a 4294967295.
string
Nome de exibição opcional para o mundo gerado, até 64 caracteres.
array
Tags opcionais da World Labs. Até 10 tags, cada uma com até 32 caracteres.
object
Objeto permission opcional da World Labs.

Resposta

string
ID público da tarefa para polling.
string
Alias do identificador de tarefa assíncrona.
string
ID da operação da World Labs.
string
URL de polling preferida para esta tarefa.
string
Status da tarefa: pending, processing, completed ou failed.
string
URL do mundo Marble gerado quando concluído.
string
URL GLB da malha collider quando disponível.
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.