Crear World

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

import requests

response = requests.post(
    "https://api.tokenlab.sh/v1/worlds/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "marble-1.1",
        "prompt": "Un tranquilo pueblo costero al atardecer con callejones estrechos y luces cálidas",
    },
)

task = response.json()
print(task["id"], task["poll_url"])

const response = await fetch('https://api.tokenlab.sh/v1/worlds/generations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer sk-your-api-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'marble-1.1',
    prompt: 'Un tranquilo pueblo costero al atardecer con callejones estrechos y luces cálidas'
  })
});

const task = await response.json();
console.log(task.id, task.poll_url);

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

POST

worlds

generations

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

import requests

response = requests.post(
    "https://api.tokenlab.sh/v1/worlds/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "marble-1.1",
        "prompt": "Un tranquilo pueblo costero al atardecer con callejones estrechos y luces cálidas",
    },
)

task = response.json()
print(task["id"], task["poll_url"])

const response = await fetch('https://api.tokenlab.sh/v1/worlds/generations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer sk-your-api-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'marble-1.1',
    prompt: 'Un tranquilo pueblo costero al atardecer con callejones estrechos y luces cálidas'
  })
});

const task = await response.json();
console.log(task.id, task.poll_url);

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

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

string

predeterminado:"marble-1.0"

Elige un modelo Marble disponible actualmente mediante la Models API.

string

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

object

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

string

Prompt de imagen en Base64 o data URL.

string

Prompt mediante URL de imagen.

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.

string

Prompt mediante URL de vídeo.

boolean | string

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

integer

Seed opcional de 0 a 4294967295.

string

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

array

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

object

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

Respuesta

string

ID público de tarea para polling.

string

Alias del identificador de tarea asíncrona.

string

ID de operación de World Labs.

string

URL de polling preferida para esta tarea.

string

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

string

URL del mundo Marble generado cuando finaliza.

string

URL GLB de la malla collider si está disponible.

string

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.

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

import requests

response = requests.post(
    "https://api.tokenlab.sh/v1/worlds/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "marble-1.1",
        "prompt": "Un tranquilo pueblo costero al atardecer con callejones estrechos y luces cálidas",
    },
)

task = response.json()
print(task["id"], task["poll_url"])

const response = await fetch('https://api.tokenlab.sh/v1/worlds/generations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer sk-your-api-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'marble-1.1',
    prompt: 'Un tranquilo pueblo costero al atardecer con callejones estrechos y luces cálidas'
  })
});

const task = await response.json();
console.log(task.id, task.poll_url);

Autorizaciones

Authorization

string

header

requerido

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

Encabezados

X-TokenLab-Delivery-Policy

enum<string>

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

Opciones disponibles:

auto,

verified,

official

Cuerpo

application/json

world_prompt

object

requerido

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.

model

enum<string>

predeterminado:marble-1.0

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.

Opciones disponibles:

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.

Maximum string length: 64

image

string

Prompt de imagen en Base64 o URL de datos.

image_url

string<uri>

Prompt de URL de imagen.

images

(string | object)[]

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.

Maximum array length: 4

video_url

string<uri>

Prompt de URL de video.

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.

Rango requerido: 0 <= x <= 4294967295

Respuesta

Tarea creada

string

task_id

string

operation_id

string

status

enum<string>

Opciones disponibles:

pending,

processing,

completed,

failed

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

object

Base

Texto

Archivos y lotes

Imágenes

Audio y tiempo real

Música

Video y recursos

Worlds

3D

Trabajos asíncronos

Gemini nativo

Administración

Cuerpo de la solicitud

Respuesta

Precios

Autorizaciones

Encabezados

Cuerpo

Respuesta

​Cuerpo de la solicitud

​Respuesta

​Precios

Autorizaciones

Encabezados

Cuerpo

Respuesta

Cuerpo de la solicitud

Respuesta

Precios