Genera panoramas de 360° a partir de texto o fotos de referencia con la API de Panoramas, o conecta un asistente de IA mediante el servidor MCP local por stdio. Ambas opciones comparten clave API, saldo de créditos y tareas asíncronas. Recibe una imagen equirrectangular 2:1 y una URL del visor. Los visores privados requieren que inicie sesión el propietario; para compartir públicamente, el panorama debe ser público.
Convierte un prompt de texto en un panorama 360° con tres llamadas REST — sin SDK que instalar y sin ninguna cola que gestionar tú.
POST /api/v1/panoramas con un prompt y una resolución (1k, 2k o 4k). Los créditos se reservan de inmediato y el endpoint responde con 202 Accepted y un id de tarea — la API de generación de panoramas 360° ejecuta el render en segundo plano.
GET /api/v1/panoramas/{id} cada pocos segundos hasta que status pase a succeeded (o failed). La generación tarda decenas de segundos, así que esta API está basada en tareas por diseño — se puede llamar sin riesgo desde funciones serverless con timeouts cortos.
Cuando termine la generación, consulta image_url, viewer_url y storage_status. La URL de la imagen puede ser temporal: espera a saved o saved-no-thumb antes de guardar la URL alojada en tu aplicación. Los visores privados requieren la sesión del propietario. Usa visibility public solo para panoramas que quieras compartir públicamente.
Crea una tarea con una sola petición POST:
curl -X POST https://panoramagenerator.com/api/v1/panoramas \
-H "Authorization: Bearer sk-..." \
-H "Content-Type: application/json" \
-d '{"prompt": "sunset over a tropical beach, palm trees", "resolution": "2k"}'Conecta un asistente de IA compatible con MCP local por stdio a tu cuenta de panoramas. El paquete independiente ofrece generación desde texto o imágenes de referencia, subida de imágenes, consulta de tareas y saldo. Usa tu clave y la misma API REST; no necesitas el código fuente del sitio. La generación es asíncrona: crea una tarea y consulta su estado, en lugar de enviar otra vez el mismo texto.
Necesitas Node.js 20 o posterior y npm/npx en tu ordenador. Crea una clave en Configuración de claves API; tu cuenta debe tener al menos un pedido pagado. La descarga no tiene un coste adicional. La generación utiliza el saldo de créditos de tu cuenta.
Configuración del cliente
{
"mcpServers": {
"panorama": {
"command": "npx",
"args": [
"-y",
"--package",
"https://panoramagenerator.com/downloads/panorama-generator-mcp-0.1.0.tgz",
"panorama-generator-mcp"
],
"env": {
"PANORAMA_API_KEY": "sk-YOUR_API_KEY"
}
}
}
}Añade esta entrada a un cliente compatible con el formato mcpServers, sustituye sk-YOUR_API_KEY por tu clave y vuelve a conectar. npx descarga y ejecuta el paquete desde este sitio. En Windows, usa npx.cmd si el cliente no puede iniciar npx. Guarda la clave en la configuración local, nunca en el chat. Otros clientes pueden utilizar otro formato.
| Herramienta | Función |
|---|---|
| generate_panorama_from_text | Crear desde texto; 1k/2k/4k cuestan 4/6/10 créditos. |
| generate_panorama_from_images | Crear desde 1–3 URL HTTPS de imágenes, con texto opcional. |
| get_panorama_task | Consultar una tarea y obtener las URL de imagen y visor. |
| get_credit_balance | Consultar el saldo sin generar imágenes. |
| upload_reference_images | Subir 1–5 imágenes en base64 sin prefijo y obtener URL públicas. |
Comprobar la conexión sin generar imágenes
Prueba de generación desde texto: 4 créditos
{
"prompt": "Una tranquila cabaña en el bosque al amanecer, panorama continuo de 360 grados",
"resolution": "1k",
"visibility": "private",
"max_credits": 4
}Llama una sola vez a generate_panorama_from_text con este JSON. Se reservan 4 créditos y recibes un id. Consulta get_panorama_task con ese id cada pocos segundos. La URL de la imagen puede ser temporal hasta que storage_status sea saved o saved-no-thumb. El visor privado requiere iniciar sesión con la cuenta propietaria. Si la tarea falla, se devuelven los créditos reservados.
Cada subida admite 1–5 archivos JPEG, PNG o WebP, de hasta 10 MiB por imagen y 20 MiB en total. Una generación admite un máximo de 3 URL HTTPS de referencia. max_credits limita una creación, no el gasto total de la cuenta. Esta versión usa stdio local y no ofrece una URL MCP remota, exportaciones HDR/EXR ni complementos para motores. Una creación que agota el tiempo de espera puede haberse cobrado; revisa tus obras antes de repetirla.
¿Prefieres partir de una foto real en lugar de un prompt? La misma API de generación de panoramas 360° acepta imágenes de referencia y las extiende hasta una escena 360° completa.
POST /api/v1/images admite hasta 5 archivos JPEG, PNG o WebP por subida, con un máximo de 10 MiB por archivo y 20 MiB en total, y devuelve image_urls alojadas. Envía como máximo 3 de esas URL HTTPS a POST /api/v1/panoramas, con un prompt opcional. El límite de subida y el de referencias por generación son distintos: subir 5 archivos no permite usar 5 referencias en una sola generación. También puedes enviar tus propias URL HTTPS públicas. El Convertidor de Imagen a 360° usa el mismo proceso desde el navegador.
Usa la imagen equirrectangular 2:1 en tu aplicación o motor de renderizado. La API REST y las herramientas MCP locales comparten el servicio de generación; la conversión a cubemap y la exportación HDR se realizan aparte en el navegador.
Genera en segundos un fondo 360° por el que parece que se puede caminar para un anuncio, un showroom o un local — sin fotógrafo ni cámara 360 para escenas de concepto o de relleno.
Llama a la API desde un pipeline de build o desde una herramienta de diseño de niveles para generar skyboxes y panoramas de fondo bajo demanda, y luego conecta la salida equirrectangular a Unity, Unreal o tu propio renderizador.
Pasa la imagen equirrectangular devuelta directamente a un visor WebXR o a un visor VR nativo como entorno inmersivo — muy práctico para prototipar escenas antes de encargar fotografía 360° real.
Añade la generación de imágenes 360° con IA como una función dentro de tu propio producto — la API de tareas asíncrona y las respuestas JSON simples encajan en cualquier lenguaje de backend, sin ningún SDK de navegador.
Genera un entorno de 360° para un configurador o una ficha de producto. Las URL de visores privados requieren la sesión del propietario. Antes de compartir enlaces con clientes, publica únicamente escenas que quieras mostrar al público.
Automatiza la generación por lotes para un pipeline de contenido — un job del CMS, una herramienta de marketing o un sistema de diseño que necesita muchos panoramas sin que nadie toque una interfaz.
Elige el formato que necesita tu motor: la API y MCP devuelven panoramas equirrectangulares; las herramientas del navegador convierten a cubemap y exportan HDR.
La API y el servidor MCP local generan una imagen equirrectangular 2:1 que puedes usar como fondo de 360° en Unity, Unreal, Blender o un visor web. Para obtener seis caras de cubo, usa el Generador de Skybox o el Generador de Cubemap en el navegador. El Generador de HDRI con IA permite exportar Radiance .hdr desde el navegador. La API v1 y esta versión de MCP no ofrecen exportación HDR/EXR ni plugins para motores. Comprueba storage_status antes de guardar la URL y publica solo las escenas que quieras compartir públicamente.
Skyboxes 360° listos para videojuegos y conversión a cubemap en el navegador, para motores que esperan seis caras de cubo en lugar de una sola imagen equirrectangular.
El mismo núcleo de generación exportado como contenedor Radiance .hdr para iluminación basada en física en Blender, Unreal y Unity — mira el Generador de HDRI con IA.
La generación por API REST y MCP usa el mismo saldo que la aplicación web. Descargar el paquete MCP no tiene coste adicional; generar imágenes sí consume créditos.
1K
1024 × 512
4 créditos
2K
2048 × 1024
6 créditos
4K
3840 × 1920
10 créditos
La generación desde texto o imágenes reserva 4/6/10 créditos para 1K/2K/4K. Las tareas fallidas devuelven los créditos reservados. Consulta el saldo con GET /api/v1/credits o la herramienta MCP get_credit_balance. Para crear una clave API, tu cuenta debe tener al menos un pedido pagado. Consulta los paquetes en precios. max_credits limita una creación por MCP, no el gasto total de la cuenta.
Códigos de estado HTTP reales más códigos de error estables y legibles por máquina, para que construyas lógica de reintento de verdad en lugar de ir adivinando.
Peticiones de escritura
10 / minuto por API key — se aplica a POST /panoramas y POST /images.
Peticiones de lectura
60 / minuto por API key — se aplica a GET /panoramas/{id} y GET /credits.
Tareas simultáneas
5 tareas de panorama en processing a la vez por cuenta, compartidas entre todas las API keys de esa cuenta.
| Estado | Código | Significado |
|---|---|---|
| 400 | invalid_request | JSON mal formado, más de 3 image_urls, una URL de imagen incorrecta, una resolution inválida o un prompt de menos de 3 caracteres sin image_urls. |
| 401 | invalid_api_key | Falta la API key Bearer o no es válida (el header x-api-key también funciona). |
| 402 | insufficient_credits | No hay créditos suficientes para la resolución solicitada — compra más y reinténtalo. |
| 404 | not_found | No existe ninguna tarea con este id en la cuenta autenticada. |
| 429 | rate_limited | Se ha superado el límite de peticiones por minuto — reinténtalo pasados los segundos que indica el header retry-after. |
| 429 | too_many_active_tasks | La cuenta ya tiene 5 tareas en processing — espera a que termine una; no se envía ningún header retry-after. |
| 502 | upstream_error | El proveedor de generación devolvió un error o agotó el tiempo de espera. Comprueba las tareas u obras existentes antes de volver a solicitar la creación. |
| 500 | internal_error | Error inesperado del servidor. Comprueba si la creación fue aceptada antes de repetirla; las solicitudes de lectura pueden reintentarse con espera progresiva. |
Envía una petición POST a /api/v1/panoramas con un prompt de texto y una resolución (1k, 2k o 4k). Reserva los créditos de inmediato y devuelve un id de tarea con status processing. Consulta GET /api/v1/panoramas/{id} cada pocos segundos hasta que status sea succeeded, y entonces lee image_url y viewer_url en la respuesta. La sección de inicio rápido de arriba incluye un ejemplo completo con curl.
Sí. La API de generación de panoramas 360° expone el mismo motor de generación de imágenes 360° con IA como un endpoint REST normal, así que puedes llamarlo desde un backend, un job de CI o un script de automatización en lugar de usar una interfaz de navegador. Si no eres desarrollador y lo que buscas es un generador de imágenes 360° con IA de apuntar y hacer clic, usa la aplicación web en Creador de Imágenes 360°.
Sube hasta 5 archivos con POST /api/v1/images y envía como máximo 3 de las image_urls HTTPS devueltas a POST /api/v1/panoramas. Cada JPEG, PNG o WebP puede ocupar hasta 10 MiB, con un máximo de 20 MiB por subida. También puedes usar URL HTTPS públicas directamente. Añade un prompt opcional para orientar la escena.
La API y MCP usan el mismo saldo: 4 créditos para 1K, 6 para 2K y 10 para 4K. Descargar el paquete MCP no tiene coste adicional. Crear una clave API requiere al menos un pedido pagado. Consulta los paquetes en precios; max_credits limita el presupuesto de una creación individual por MCP.
La API y MCP devuelven una imagen equirrectangular 2:1 en 1K, 2K o 4K, junto con image_url, viewer_url y storage_status. Espera a saved o saved-no-thumb antes de guardar la URL alojada. Los visores privados requieren la sesión del propietario; los panoramas públicos tienen enlaces públicos. La API v1 y esta versión de MCP no exportan HDR/EXR.
Las tareas de generación fallidas devuelven los créditos reservados. Un timeout o un error de conexión no demuestra por sí solo que la creación haya fallado: el servidor puede haberla aceptado. Consulta el estado o tus obras antes de repetir la solicitud. La API y MCP usan el mismo servicio de generación y créditos.
Descarga el paquete MCP local y añade la configuración anterior a un cliente compatible con MCP por stdio. Necesitas Node.js 20 o posterior y una clave API. Llama una vez a generate_panorama_from_text o generate_panorama_from_images y consulta get_panorama_task con el id devuelto. Verifica primero la conexión con get_credit_balance y la prueba de presupuesto max_credits 0.
Esta versión ofrece un servidor MCP local por stdio, no una URL alojada de conexión HTTP o SSE. Tu cliente MCP inicia el paquete con npx en tu ordenador y el paquete llama a la API REST alojada con tu clave. Un cliente que solo acepta URL MCP remotas no puede conectarse directamente a este paquete local.
Genera panoramas 360° a partir de texto en el navegador — el mismo motor que hay detrás de esta API.
Convierte una foto real en un panorama 360°, sin necesidad de API key.
Previsualiza cualquier imagen equirrectangular o salida de la API en un visor interactivo.
Empieza a generar panoramas 360° por código
Prueba la aplicación web con los créditos de registro. Tras al menos un pedido pagado, puedes crear una clave para llamar a la API REST o usar el servidor MCP local.
Ver precios