Saltar al contenido principal
Genera mundos 3D explorables con World Labs Marble. Esta API es asíncrona: las respuestas de creación devuelven una identidad de tarea y una poll_url para comprobar el estado. Los modelos compatibles son marble-1.0, marble-1.1 y marble-1.1-plus. World Labs documenta marble-1.0-draft, pero TokenLab todavía no expone la generación draft en este endpoint.

​
Cuerpo de la solicitud

​
model
string
predeterminado:"marble-1.0"
Modelo Marble a usar: marble-1.0, marble-1.1 o marble-1.1-plus.
​
prompt
string
Prompt de texto para generación solo con texto o como guía con entradas de imagen/vídeo.
​
world_prompt
object
Objeto nativo de World Labs world_prompt para llamadas avanzadas. Los tipos soportados son text, image, multi-image y video.
​
image
string
Prompt de imagen en Base64 o data URL.
​
image_url
string
Prompt mediante URL de imagen.
​
images
array
Varios prompts de imagen para generación multi-image rápida. Proporciona hasta 4 imágenes. Para el modo de reconstrucción nativo de World Labs, pasa world_prompt.type="multi-image" con reconstruct_images: true y hasta 8 imágenes.
​
video_url
string
Prompt mediante URL de vídeo.
​
is_pano
boolean | string
Para entradas de imagen, usa true para un panorama existente, false para una imagen normal, o auto.
​
seed
integer
Seed opcional de 0 a 4294967295.
​
display_name
string
Nombre visible opcional para el mundo upstream, hasta 64 caracteres.
​
tags
array
Tags upstream opcionales. Hasta 10 tags, 32 caracteres cada uno.
​
permission
object
Objeto permission de World Labs opcional.

​
Respuesta

​
id
string
ID público de tarea para polling.
​
task_id
string
Alias del identificador de tarea asíncrona.
​
operation_id
string
ID de operation upstream de World Labs.
​
poll_url
string
URL de polling preferida para esta tarea.
​
status
string
Estado de la tarea: pending, processing, completed o failed.
​
world_marble_url
string
URL del mundo Marble generado cuando finaliza.
​
glb_url
string
URL GLB de la malla collider si está disponible.
​
pano_url
string
URL de imagen panorámica si está disponible.

​
Precios

World Labs factura en credits. TokenLab descuenta primero el máximo del tipo de solicitud y liquida según cost.total_credits de la operation completada cuando está disponible. Las solicitudes Marble estándar llegan hasta 1.600 credits. marble-1.1-plus llega hasta 3.100 credits.

​
Alcance

Estos endpoints de gestión cubren medios propiedad de TokenLab y Worlds generados completados. TokenLab todavía no expone generación marble-1.0-draft ni herramientas pano/depth independientes. 
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": "Un tranquilo pueblo costero al atardecer con callejones estrechos y luces cálidas"
  }'