> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Worlds

> Genera Worlds explorables, sube prompts multimedia, consulta tareas y administra Worlds completados.

La generación World crea Marble Worlds explorables de forma asíncrona. Usa Worlds cuando el resultado sea un entorno que los usuarios puedan abrir o revisar. Usa generación 3D cuando necesites un modelo independiente.

## Entradas Y Media Assets

Las tareas World pueden empezar desde texto, imágenes, varias imágenes o video según el modelo seleccionado y la forma de la solicitud. Para prompts multimedia reutilizables, prepara primero un media asset y luego referéncialo en la solicitud World. Los media assets y Worlds completados solo están disponibles para tu cuenta.

## Crear Y Consultar

Las respuestas de creación incluyen un ID público de tarea y normalmente una poll\_url. Guarda ese ID antes de mostrar progreso y luego sigue poll\_url o GET /v1/tasks/{id} hasta que la tarea sea completed o failed.

```bash theme={null}
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": "A quiet coastal town at sunset with narrow alleys and warm lights"
  }'
```

## Administrar Worlds Completados

Usa los endpoints de lista y detalle de Worlds para Worlds completados disponibles en tu cuenta. Usa endpoints de estado de tarea para generaciones pendientes o fallidas. Elimina solo cuando el usuario quite intencionalmente el World generado de tu producto.

## Errores Comunes

* No asumas que todos los modelos World soportan todos los tipos de entrada.
* Mantén las URLs firmadas de imagen o video válidas el tiempo suficiente para reintentos de descarga del servicio.
* Guarda el ID de tarea devuelto antes de reintentar tras un timeout.
* Usa generación 3D para archivos de modelo descargables, no para Worlds explorables.

## Referencia API

| Tema                           | Referencia                                                                            |
| ------------------------------ | ------------------------------------------------------------------------------------- |
| Crear World                    | [Crear World](/es/api-reference/worlds/create-world)                                  |
| Obtener Estado De World        | [Obtener Estado De World](/es/api-reference/worlds/get-world-status)                  |
| Preparar Subida De Media Asset | [Preparar Subida De Media Asset](/es/api-reference/worlds/prepare-media-asset-upload) |
| Obtener Media Asset            | [Obtener Media Asset](/es/api-reference/worlds/get-media-asset)                       |
| Listar Worlds                  | [Listar Worlds](/es/api-reference/worlds/list-worlds)                                 |
| Obtener World                  | [Obtener World](/es/api-reference/worlds/get-world)                                   |
| Eliminar World                 | [Eliminar World](/es/api-reference/worlds/delete-world)                               |
| Tareas asíncronas              | [Tareas asíncronas](/es/guides/async-jobs-polling)                                    |
| Guía De Generación 3D          | [Guía De Generación 3D](/es/guides/3d-generation)                                     |