Criar World

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.

Escolha um modelo Marble disponível atualmente pela Models API.

Corpo da requisição

modelstringpadrão: marble-1.0

Escolha um modelo Marble disponível atualmente pela Models API.

promptstring

Prompt de texto para geração somente texto ou como guia com entradas de imagem/vídeo.

world_promptobject

Objeto nativo World Labs world_prompt para chamadas avançadas. Tipos suportados: text, image, multi-image e video.

imagestring

Prompt de imagem em Base64 ou data URL.

image_urlstring

Prompt por URL de imagem.

imagesarray

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_urlstring

Prompt por URL de vídeo.

is_panoboolean | string

Para entradas de imagem, use true para panorama existente, false para imagem única normal, ou auto.

seedinteger

Seed opcional de 0 a 4294967295.

display_namestring

Nome de exibição opcional para o mundo gerado, até 64 caracteres.

tagsarray

Tags opcionais da World Labs. Até 10 tags, cada uma com até 32 caracteres.

permissionobject

Configurações opcionais de visibilidade e acesso: public, allow_id_access, allowed_readers e allowed_writers. public: true solicita um mundo visível publicamente.

Resposta

idstring

ID público da tarefa para polling.

task_idstring

Alias do identificador de tarefa assíncrona.

operation_idstring

ID da operação da World Labs.

poll_urlstring

URL de polling preferida para esta tarefa.

statusstring

Status da tarefa: pending, processing, completed ou failed.

world_marble_urlstring

URL do mundo Marble gerado quando concluído.

glb_urlstring

URL GLB da malha collider quando disponível.

pano_urlstring

URL da imagem panorâmica quando disponível.

Preços

Consulte a Pricing API para ver as tarifas atuais. O valor faturado aparece nos registros de uso; o valor retornado em cost.total_credits indica uso de geração, não uma quantia em moeda.

Requisição

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"
  }'

{  "id": "string",  "task_id": "string",  "operation_id": "string",  "status": "pending",  "poll_url": "string",  "world_id": "string",  "world_marble_url": "string",  "model_url": "string",  "glb_url": "string",  "pano_url": "string",  "thumbnail_url": "string",  "caption": "string",  "cost": {},  "error": "string",  "error_details": {    "projection_version": 0,    "status": 400,    "message": "string",    "type": "string",    "code": "string",    "param": "string",    "retryable": true,    "upstream": {      "source": "string",      "code": "string",      "message": "string",      "param": "string"    }  }}

Autorização

BearerAuth

AuthorizationBearer <token>

Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.

Local: header

Cabeçalhos

X-TokenLab-Delivery-Policy?string

Política de entrega por solicitação. Substitui os padrões da API key e do Workspace. Tenta automaticamente o TokenLab Verified primeiro e pode alternar uma vez para Official apenas antes da saída, aceitação da solicitação ou criação de recurso persistente.

Valores permitidos

"auto"
"verified"
"official"

Corpo da requisição

application/json

model?string

Modelo Marble a ser usado. O padrão é marble-1.0 para corresponder ao padrão de compatibilidade atual do World Labs quando o modelo é omitido.

padrão"marble-1.0"

Valores permitidos

"marble-1.0"
"marble-1.1"
"marble-1.1-plus"

prompt?string

Prompt de texto usado para geração de mundo por texto ou imagem/vídeo guiado.

display_name?string

Nome de exibição opcional para o mundo gerado, até 64 caracteres.

Comprimentolength <= 64

world_prompt*

Objeto world_prompt nativo do World Labs para chamadores avançados. Os tipos de prompt suportados são text, image, multi-image e video. Referências de conteúdo podem usar source=media_asset com um media_asset_id preparado por /v1/worlds/media-assets/prepare-upload.

image?string

Prompt de imagem em Base64 ou URL de dados.

image_url?string

Prompt de URL de imagem.

Formatouri

images?array<string|>

Atalhos para prompts de múltiplas imagens. Forneça até 4 imagens. Use world_prompt.reconstruct_images=true nativo para até 8 imagens.

Itensitems <= 4

video_url?string

Prompt de URL de vídeo.

Formatouri

is_pano?|

Se um prompt de imagem é um panorama existente. Use true para entrada pano, false para entrada de imagem única ou auto.

seed?integer

Seed opcional de 0 a 4294967295.

Intervalo0 <= value <= 4294967295

tags?array<>

Tags opcionais do World Labs. Forneça até 10 tags, cada uma com até 32 caracteres.

Itensitems <= 10

permission?

Objeto de permissão opcional do World Labs.

user?string

Identificador do usuário final.

Criar World

Corpo da requisição

Resposta

Preços

Autorização

Cabeçalhos

Corpo da requisição

Resposta

`application/json`

`application/json`

`application/json`

Criar World

Corpo da requisiçãoCopy Anchor Link

RespostaCopy Anchor Link

PreçosCopy Anchor Link

AutorizaçãoCopy Anchor Link

CabeçalhosCopy Anchor Link

Corpo da requisiçãoCopy Anchor Link

RespostaCopy Anchor Link

200application/json

401application/json

503application/json

Corpo da requisição

Resposta

Preços

Autorização

Cabeçalhos

Corpo da requisição

Resposta

`application/json`

`application/json`

`application/json`