Crear World

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.

Elige un modelo Marble disponible actualmente mediante la Models API.

Cuerpo de la solicitud

modelstringpredeterminado: marble-1.0

Elige un modelo Marble disponible actualmente mediante la Models API.

promptstring

Prompt de texto para generación solo con texto o como guía con entradas de imagen/vídeo.

world_promptobject

Objeto nativo de World Labs world_prompt para llamadas avanzadas. Los tipos soportados son text, image, multi-image y video.

imagestring

Prompt de imagen en Base64 o data URL.

image_urlstring

Prompt mediante URL de imagen.

imagesarray

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_urlstring

Prompt mediante URL de vídeo.

is_panoboolean | string

Para entradas de imagen, usa true para un panorama existente, false para una imagen normal, o auto.

seedinteger

Seed opcional de 0 a 4294967295.

display_namestring

Nombre visible opcional para el mundo generado, hasta 64 caracteres.

tagsarray

Tags opcionales de World Labs. Hasta 10 tags, 32 caracteres cada uno.

permissionobject

Ajustes opcionales de visibilidad y acceso: public, allow_id_access, allowed_readers y allowed_writers. public: true solicita un mundo visible públicamente.

Respuesta

idstring

ID público de tarea para polling.

task_idstring

Alias del identificador de tarea asíncrona.

operation_idstring

ID de operación de World Labs.

poll_urlstring

URL de polling preferida para esta tarea.

statusstring

Estado de la tarea: pending, processing, completed o failed.

world_marble_urlstring

URL del mundo Marble generado cuando finaliza.

glb_urlstring

URL GLB de la malla collider si está disponible.

pano_urlstring

URL de imagen panorámica si está disponible.

Precios

Consulta la Pricing API para ver las tarifas actuales. El importe facturado aparece en tus registros de uso; el valor cost.total_credits devuelto indica uso de generación, no un importe monetario.

Solicitud

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

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

Autorización

BearerAuth

AuthorizationBearer <token>

Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.

Ubicación: header

Encabezados

X-TokenLab-Delivery-Policy?string

Política de entrega por solicitud. Sustituye los valores predeterminados de la API key y del Workspace. Auto intenta primero con TokenLab Verified y puede cambiar una vez a Official solo antes de la salida, la aceptación de la solicitud o la creación de recursos persistentes.

Valores permitidos

"auto"
"verified"
"official"

Cuerpo de la solicitud

application/json

model?string

Modelo Marble a utilizar. Por defecto es marble-1.0 para coincidir con el valor predeterminado de compatibilidad actual de World Labs cuando se omite el modelo.

predeterminado"marble-1.0"

Valores permitidos

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

prompt?string

Prompt de texto utilizado para la generación de mundos mediante texto o imágenes/videos guiados.

display_name?string

Nombre para mostrar opcional para el mundo generado, hasta 64 caracteres.

Longitudlength <= 64

world_prompt*

Objeto world_prompt nativo de World Labs para llamadores avanzados. Los tipos de prompt admitidos son text, image, multi-image y video. Las referencias de contenido pueden usar source=media_asset con un media_asset_id preparado por /v1/worlds/media-assets/prepare-upload.

image?string

Prompt de imagen en Base64 o URL de datos.

image_url?string

Prompt de URL de imagen.

Formatouri

images?array<string|>

Prompts de atajo para múltiples imágenes. Proporcione hasta 4 imágenes. Utilice world_prompt.reconstruct_images=true nativo para hasta 8 imágenes.

Elementositems <= 4

video_url?string

Prompt de URL de video.

Formatouri

is_pano?|

Si un prompt de imagen es un panorama existente. Use true para entrada pano, false para entrada de imagen única, o auto.

seed?integer

Seed opcional de 0 a 4294967295.

Rango0 <= value <= 4294967295

tags?array<>

Etiquetas opcionales de World Labs. Proporcione hasta 10 etiquetas, cada una de hasta 32 caracteres.

Elementositems <= 10

permission?

Objeto de permiso opcional de World Labs.

user?string

Identificador del usuario final.

Crear World

Cuerpo de la solicitud

Respuesta

Precios

Autorización

Encabezados

Cuerpo de la solicitud

Respuesta

`application/json`

`application/json`

`application/json`

Crear World

Cuerpo de la solicitudCopy Anchor Link

RespuestaCopy Anchor Link

PreciosCopy Anchor Link

AutorizaciónCopy Anchor Link

EncabezadosCopy Anchor Link

Cuerpo de la solicitudCopy Anchor Link

RespuestaCopy Anchor Link

200application/json

401application/json

503application/json

Cuerpo de la solicitud

Respuesta

Precios

Autorización

Encabezados

Cuerpo de la solicitud

Respuesta

`application/json`

`application/json`

`application/json`