PopNowDocs de la API
Referencia y ayuda
Contenido principal

Registro de cambios

Cambios con fecha en la API de generación de imágenes, video y audio de PopNow AI, el servidor MCP remoto, los webhooks, la facturación y esta documentación que afectan a los desarrolladores.

Cambios que afectan al código que has escrito contra PopNow, del más reciente al más antiguo. También se listan las novedades que no requieren ninguna acción, para que veas qué se ha hecho posible. Las fechas son en UTC.

Nada de lo que aparece abajo rompe una integración existente, salvo que diga Acción requerida.

2026-10-23

Acción requerida: saldo independiente de la API en USD. Las llamadas con clave de API, MCP con clave de API y las ejecuciones de Playground gastan un saldo independiente de la API en USD, que empieza en $0. Los créditos de la web y los fondos de la API no se pueden transferir ni usar uno en lugar del otro. MCP con OAuth sigue gastando créditos de la web. Los precios de los modelos mantienen la misma tarifa. Crea las claves en API keys; añade fondos y consulta los pagos de la API en API billing. Usa los campos en USD existentes (costUsd, estimatedCostUsd, maxChargeUsd, availableUsd, heldUsd, totalUsd, totalSpend) para mostrar importes y llevar la contabilidad. Confirma las cotizaciones mediante los campos en USD existentes: pasa quoteId y expectedCostUsd: quote.maxChargeUsd con la misma solicitud antes de que caduque la cotización. Consulta Facturación de la API y Saldo de la API y reembolsos. Las entradas anteriores de abajo describen el comportamiento en sus fechas, incluido el antiguo modelo de créditos compartidos y el redondeo a créditos enteros.

Acción requerida: aprobación en USD de recetas guardadas. Las ejecuciones de recetas y flujos de trabajo mediante REST y MCP con clave de API ahora usan cotizaciones en USD: solicita una cotización y después confirma las mismas entradas con currency: "USD", max_usd como cadena decimal y quote_id. Los antiguos límites en créditos se rechazan. Consulta y reanuda la ejecución con su clave original. El nuevo endpoint de reanudación y la herramienta resume_recipe_run permiten cotizar y aprobar el presupuesto de toda la ejecución, incluidos los fondos gastados y los compromisos en curso. Una cotización con unpriced_steps cubre solo los pasos cuyo precio ya está calculado; los pasos posteriores esperan una nueva cotización y aprobación. Las ejecuciones de recetas mediante MCP con OAuth siguen usando créditos de la web. Consulta Recetas guardadas.

Modelos de chat en la documentación. Claude, Gemini, DeepSeek, GLM, Grok y Kimi se pueden llamar con la misma clave de API a través de OpenAI Chat Completions y Responses (https://api.popnow.ai/v1), Anthropic Messages y Gemini generateContent, con precio por token en USD. En Modelos de chat encontrarás las URL base, ejemplos con SDK, el streaming, los precios por token y cómo se cobra cada solicitud; la referencia de la API lista las rutas, junto con los endpoints de recetas, skills y agent skills que antes faltaban.

Documentación más fácil de recorrer. La página de inicio de la documentación ahora tiene la misma barra lateral que el resto de páginas, la barra lateral se reagrupa según lo que estás haciendo, y cada página está disponible en los 12 idiomas.

2026-10-22

SDK e integraciones en los registros de paquetes. Los paquetes oficiales de código abierto ya no necesitan instalarse desde GitHub:

  • Python: pip install popnow (PyPI). JavaScript y TypeScript: npm install popnow (npm, también en JSR). CLI: npm install -g @popnow/cli.
  • PHP: composer require popnow/popnow (Packagist). Go: go get github.com/popnow-ai/popnow-go. Novedad: un cliente de Java, ai.popnow:popnow-java en Maven Central.
  • ComfyUI: el paquete de nodos es popnow-comfyui en el Comfy Registry. Instálalo desde ComfyUI Manager o con comfy node install popnow-comfyui. El nodo de un solo archivo sigue funcionando; usa uno u otro.
  • n8n: el nodo de la comunidad n8n-nodes-popnow está en npm. En n8n autoalojado, instálalo desde Settings > Community Nodes. Todavía no es un nodo verificado, así que n8n Cloud sigue usando el flujo con HTTP Request.
  • También nuevo: popnow-proxy (npm install @popnow/proxy) mantiene tu clave de API en tu servidor cuando una aplicación web o móvil llama a la API, y popnow-bot es un bot autoalojado de Telegram y Discord. El puente stdio de MCP se ejecuta con npx -y @popnow/mcp.

Si instalaste desde GitHub antes, puedes cambiar al paquete del registro; los imports no cambian. SDK, CLI y herramientas de código abierto reúne todos los comandos.

2026-10-21

Ejecuta tus recetas, flujos y skills guardados. Las recetas guardadas en Studio, los flujos guardados desde el lienzo y las skills de Poppie ya se pueden listar y ejecutar desde la API: GET /api/v1/recipes, POST /api/v1/recipes/{id}/run (con maxCredits para limitar el precio) y GET /api/v1/recipes/runs/{runId}, además de GET /api/v1/skills. MCP añade cinco herramientas equivalentes: list_my_recipes, run_my_recipe, get_recipe_run, list_my_skills y use_my_skill. Todo sigue siendo privado para ti y tus equipos. Consulta Tus recetas, flujos y skills; la consola para desarrolladores tiene una nueva página de Recetas y skills con el ID de cada elemento y código listo para ejecutar.

2026-10-19

Acción requerida: ahora 1 crédito son 0,001 USD, y los precios son más bajos. Antes un crédito valía 0,01 USD; ahora vale 0,001 USD. Cada saldo, precio e importe en créditos es 10 veces el número anterior, por el mismo valor en dólares. Al mismo tiempo, los precios de todos los modelos bajaron alrededor de un tercio, así que la misma solicitud cuesta ahora menos dólares que antes.

  • Tu saldo se convirtió. No se perdió nada: un saldo de 500 créditos (5 USD) ahora son 5.000 créditos (5 USD). Los topes de gasto de tus claves mantienen el mismo valor en dólares y muestran las nuevas cifras en créditos.
  • Campos de la API. credits, maxCredits, expectedCredits, estimatedCredits, availableCredits, heldCredits, totalCredits y los precios credits de GET /api/v1/models están todos en la nueva unidad. Las cadenas en dólares (cost, maxCharge, estimatedCost, available …) significan lo mismo que siempre. Si tu código convierte créditos a dólares dividiendo entre 100, divide entre 1.000 en su lugar; si guarda umbrales o presupuestos en créditos, multiplícalos por 10.
  • Cotizaciones antiguas. Un quoteId y un expectedCredits de antes del cambio ya no coinciden. createTask responde 40901 (precio cambiado) y no retiene nada; vuelve a cotizar y muestra el nuevo precio.
  • Redondeo. Una tarea sigue cobrándose en créditos enteros, redondeados hacia arriba, pero un crédito entero ahora es una décima de centavo, así que el redondeo es diez veces menor.
  • MCP. Las tareas de hasta 300 créditos empiezan de inmediato; las más grandes siguen esperando el «sí» del usuario. Consulta Usar PopNow en ChatGPT y Claude.
  • Paquetes de créditos. Los paquetes empiezan en 9 USD por 9.000 créditos, con créditos extra en los más grandes, y ahora puedes comprar una cantidad personalizada de entre 10 y 2.000 USD a 1.000 créditos por cada USD. Consulta la página de precios y Créditos, precios y reembolsos.

SDK y herramientas de código abierto. El código para desarrolladores de PopNow ya es público en github.com/popnow-ai, con licencia MIT: SDK para Python y JavaScript y TypeScript, una CLI, clientes para Go y PHP, la guía de configuración de MCP, Agent Skills, el archivo OpenAPI con ejemplos, y el código fuente del complemento de Blender, del paquete de nodos de ComfyUI y del nodo de comunidad de n8n.

  • Todavía ninguno está en npm, PyPI, Packagist ni el ComfyUI Registry. Instala desde GitHub como se muestra en la nueva página de SDK, CLI y herramientas de código abierto.
  • El Inicio rápido muestra los SDK de Python y JavaScript junto a los ejemplos HTTP sencillos, que siguen igual.

2026-10-17

Servidor MCP remoto. PopNow ya ofrece un servidor MCP en https://api.popnow.ai/mcp. Las personas pueden añadirlo a ChatGPT o Claude y crear imágenes, videos, canciones y locuciones en un chat; los desarrolladores pueden añadirlo a Cursor, VS Code, Claude Code o a su propio cliente MCP. Doce herramientas, inicio de sesión con OAuth 2.1 o una clave de API sk-popnow-, con los mismos créditos y precios que en el resto de la plataforma. Las tareas de hasta 30 créditos (300 desde el 2026-10-19) empiezan de inmediato; las más grandes esperan la confirmación del usuario. Consulta Usar PopNow en ChatGPT y Claude.

  • Las conexiones se pueden revisar y eliminar en Account settings → Devices → Connected AI apps.
  • Las llamadas hechas con una clave de API cuentan para los topes de gasto de esa clave y aparecen en los registros de la consola.
  • Los efectos de video (Zombie Turn, Flying Car y el resto de la página de Efectos) están disponibles para las aplicaciones de chat a través de apply_effect. No son endpoints REST.

Documentación nueva. Créditos, precios y reembolsos, guías de integración para n8n, ComfyUI y el complemento de Blender, Recetas y este registro de cambios. Webhooks incorporó una sección sobre cómo gestionar los endpoints de la cuenta en la consola.

Reglas de reembolso de paquetes de créditos. Un paquete de créditos se puede reembolsar dentro de los 7 días posteriores a la compra (14 días para consumidores de la UE y del Reino Unido) si ninguno de sus créditos se ha usado; las generaciones fallidas siguen reembolsándose automáticamente. Los créditos gratuitos de recompensa se gastan antes que los de los paquetes, y los paquetes, del más antiguo al más nuevo. Detalles: Créditos, precios y reembolsos.

Páginas de integración en popnow.ai. Las páginas de n8n, ComfyUI y Recetas ahora muestran resultados reales junto al código que generan.

2026-10-16

La API de PopNow se abrió. Una sola API REST para generar imágenes, video y audio en https://api.popnow.ai/api/v1, documentada aquí en popnow.ai/docs en 12 idiomas, con el archivo OpenAPI y llms.txt para herramientas y agentes.

  • Las claves empiezan por sk-popnow-. Las claves creadas antes del cambio de prefijo siguen funcionando; no hay que rotar nada.
  • Los importes van en créditos (1 crédito = 0,01 USD al lanzamiento, 0,001 USD desde el 2026-10-19): credits, maxCredits, expectedCredits, availableCredits y los demás campos de créditos aparecen junto a las cadenas en dólares. Usa los campos de créditos.
  • Los IDs de modelo tienen el formato <maker>/<model>/<task>, por ejemplo google/nano-banana-2.1/text-to-image. Las herramientas propias de PopNow usan popnow como fabricante.
  • Referencias popnow:// para las subidas (popnow://f/…) y los elementos de la biblioteca de recursos (popnow://a/…), utilizables en cualquier campo de medios. Consulta Medios.
  • Los modelos de chat y de texto no forman parte de la API pública. La API cubre la generación de imágenes, video y audio.

Versión 2 del payload de webhooks. Los nuevos callbacks de tareas se envían con X-Webhook-Payload-Version: 2, y el cuerpo coincide con recordInfo. Consulta Webhooks.

Consola para desarrolladores. Endpoints de webhook a nivel de cuenta (firmas de Standard Webhooks, hasta 16 por cuenta, un secreto por endpoint), un registro de entregas con reenvío manual, ejecuciones en el Playground de la página de API de cada modelo, filtros de claves en los registros y exportación de uso en CSV.

Revisión de contenido al enviar. Los prompts y las imágenes de entrada se revisan antes de aceptar una tarea. Una solicitud rechazada devuelve 400 con un data.reason, no retiene nada y no cuesta nada. Las solicitudes que el propio modelo rechaza siguen fallando como content_rejected sin coste.

Mensajes de error en chino. msg y errorMessage ahora siguen Accept-Language también para zh-CN y zh-TW, además de los diez idiomas ya compatibles. Los códigos no cambian. Consulta Errores.

Las rutas de video compatibles con OpenAI bajo /v1 también aceptan la clave en una cabecera x-api-key. Consulta Compatibilidad con OpenAI Videos.

Complemento de Blender 0.1.0. Renderiza, anima y aplica texturas desde una escena de arcilla en Blender 4.2 o posterior con tu clave de API. Consulta Complemento de Blender.

2026-10-15

Biblioteca de recursos: personajes. Los personajes (un conjunto con nombre de imágenes de referencia organizado en la web) se guardan en la biblioteca de recursos y se pueden leer con GET /api/v1/assets/entities; cada imagen tiene su propio URI popnow://a/… para las solicitudes de generación. Los personajes se crean y editan en la web; la API solo los lee. Consulta Recursos y archivos LoRA.

En esta página