API de v0: cómo crear y desplegar aplicaciones con IA

Qué ofrece realmente la API de v0

La API de v0 convierte una petición en lenguaje natural en una aplicación full stack en ejecución, no solo en una sugerencia de código. Genera el código, ejecuta el resultado en un Vercel Sandbox, ofrece una previsualización segura y proporciona una vía directa para desplegar en Vercel.

Cada chat de v0 funciona como un taller privado dedicado a una aplicación. El ID del chat es la llave de ese taller: v0 puede leer, editar y ejecutar sus archivos, y cada mensaje posterior parte del estado actual. Si el primer mensaje solicita un panel para clasificar incidencias y el siguiente pide una columna de responsables, la segunda petición modifica la aplicación que ya estaba en la mesa de trabajo.

Ese ciclo con estado es lo que marca la diferencia. Un modelo de código convencional entrega texto y deja la ejecución en tus manos. v0 inicia el servidor de desarrollo, comprueba el código en funcionamiento y puede detectar y corregir errores mientras trabaja.

La nueva API v2 se organiza en torno a cuatro elementos fáciles de entender sin conocer su funcionamiento interno:

• Chats: conservan los archivos actuales de la aplicación, sus metadatos, la configuración de privacidad y el vínculo con el proyecto de Vercel.
• Mensajes: contienen las instrucciones y el historial. La secuencia ordenada de parts puede mostrar texto, razonamiento, lecturas y ediciones de archivos, búsquedas, comandos de shell, llamadas a herramientas y acciones del agente.
• Previsualizaciones: son compilaciones en ejecución protegidas por un token de corta duración.
• Despliegues: llevan a Vercel el estado actual del chat.

Por eso los ejemplos antiguos pueden resultar engañosos. El quickstart actual de v2 importa desde el paquete v0. Los ejemplos anteriores de v1 importan desde v0-sdk, y los ID de chat de v1 no funcionan en v2.

Cómo usar la API de v0

La ruta segura más corta consiste en interponer un pequeño endpoint de servidor entre tu interfaz y v0. El navegador envía el prompt del usuario a tu servidor; este conserva la clave de API, llama a v0, guarda el ID de chat recibido y devuelve únicamente el resultado que necesita la interfaz.

1. Elige el punto de entrada adecuado

Hay tres opciones:

1. Iniciar una interfaz completa de generación de aplicaciones con npx create-v0-sdk-app.
2. Añadir el SDK de servidor a un producto existente con npm install v0.
3. Dar acceso a un agente existente mediante el servidor MCP remoto de v0, que utiliza OAuth en lugar de colocar una clave de API en la configuración de MCP.

El starter es la forma más rápida de ver el patrón completo. Incluye una interfaz de chat en React, rutas proxy en el servidor, vistas de los archivos generados, una aplicación de previsualización aislada y una skill para el agente de v0.

2. Crea la clave y guárdala en el servidor

Crea una clave de API en la configuración de v0 y guárdala como V0_API_KEY en el entorno del servidor. No la expongas en el código del navegador ni le añadas el prefijo NEXT_PUBLIC_.

Tu wrapper local puede ejecutarse con npm run dev, pero sus rutas de servidor seguirán llamando a la API alojada de v0. Es una integración local, no una copia local del sistema de creación de aplicaciones de v0.

3. Crea un chat por aplicación

La primera llamada inicia a la vez una conversación y el espacio de trabajo de la aplicación:

import { v0 } from 'v0'

const created = await v0.chats.create({
  message: 'Build an issue triage app for a support team.',
})

if (created.error) throw new Error(created.error.message)
const chatId = created.data.chat.id

const changed = await v0.messages.send({
  chatId,
  message: 'Add a priority filter and an assignee column.',
})

if (changed.error) throw new Error(changed.error.message)

Guarda chatId junto al registro correspondiente de tu cliente, espacio de trabajo o tarea. Los metadatos también permiten agrupar chats mediante esos mismos identificadores, pero sirven para organizar, no para controlar el acceso.

No es obligatorio partir de un prompt vacío. El chat puede iniciarse desde un repositorio de GitHub, un archivo ZIP o un conjunto de archivos.

4. Elige cómo recibir el trabajo

Usa una llamada síncrona cuando quien la inicia pueda esperar al resultado final. Elige una llamada asíncrona para scripts, webhooks y tareas de CI que deban ponerse en cola y consultarse más tarde. Recurre al streaming cuando haya una persona observando y quieras que la interfaz muestre al agente mientras lee archivos, edita código, ejecuta comandos e informa sobre el avance.

Las respuestas de chats y mensajes incluyen el consumo, de modo que puedes registrar el número de tokens y el costo en créditos al terminar cada tarea.

5. Pasa la previsualización por un proxy; no la expongas directamente

La API devuelve una URL de previsualización y un token de corta duración. Un iframe en el navegador no puede adjuntar ese token de forma segura, por lo que el diseño documentado dirige las solicitudes del iframe a través de un proxy backend bajo tu control.

Aloja el proxy en un sitio exclusivo para previsualizaciones, con un dominio registrable distinto al de tu aplicación principal. Las previsualizaciones generadas pueden ejecutar código no confiable. Además, el proxy debe autenticar al usuario actual y comprobar que tenga permiso para acceder al chat solicitado. El helper de previsualización de v0 no realiza esa autorización por ti.

6. Despliega solo después de tus propias comprobaciones

Cuando la aplicación esté lista, v0.chats.deploy({ chatId }) despliega en Vercel el estado actual del chat. Las variables de entorno pertenecen al proyecto de Vercel asociado y se administran mediante la API de Vercel, así que las credenciales de bases de datos y las claves de terceros exigen un paso de configuración separado y deliberado.

Cuánto cuesta

v0 cobra mediante créditos, no con un precio fijo por aplicación generada. Los tokens de entrada abarcan el prompt, el contenido subido, el historial del chat, los archivos de código fuente y cualquier otro contexto que lea v0. Los tokens de salida corresponden a lo que genera el agente. Por eso, un chat prolongado puede costar más a medida que crecen su historial y su base de código.

El plan Free cuesta $0 al mes, incluye $5 en créditos mensuales y tiene un límite diario de siete mensajes. Plus cuesta $30 por usuario al mes y Business, $100 por usuario al mes; ambos incluyen $30 en créditos mensuales por usuario. La generación se detiene cuando se agotan los créditos disponibles.

Si el producto está orientado a clientes, registra el consumo que devuelve cada llamada de chat y de mensaje. Asigna a cada tenant un presupuesto, un límite de tareas o ambos. De lo contrario, un repositorio excepcionalmente grande o un ciclo interminable de revisiones puede consumir el saldo compartido.

Siete casos de uso, ordenados por quién obtiene más valor

Los mejores usos integran v0 en un flujo existente, donde el producto ya conoce al usuario, los datos y el tipo de aplicación que debe construir.

Si estás decidiendo si v0 debe ser el motor subyacente o el producto completo que necesitas, compáralo con los mejores generadores de aplicaciones con IA en 2026. La diferencia es importante: una API resulta útil cuando quieres controlar la experiencia del cliente, las reglas, la facturación y el flujo de revisión.

Tres productos que vale la pena crear

Existe demanda real, pero el mercado de generadores de aplicaciones genéricos ya está saturado. La oportunidad no consiste en lanzar otra caja vacía para escribir prompts, sino en crear un generador que domine un trabajo valioso y específico.

1. La mejor apuesta: un generador de aplicaciones vertical dentro de un SaaS existente

Crea un generador acotado para una sola profesión y véndelo como complemento del software que esos clientes ya utilizan. Una plataforma de gestión inmobiliaria podría generar portales para propietarios; una plataforma logística, paneles de excepciones en envíos; y una plataforma para franquicias, tableros de seguimiento para la apertura de locales.

La demanda es lo bastante amplia como para sostener la categoría. ai app builder recibe unas 12,100 búsquedas mensuales en Google de Estados Unidos, y el conjunto de datos registra un crecimiento interanual del 50%. Los usuarios piden a los asistentes de IA build an app with ai unas 392 veces al mes, frente a 231 en agosto de 2025: un crecimiento cercano al 70%. Los generadores de aplicaciones existentes ya cobran entre $16 y $160 al mes, lo que demuestra que los compradores aceptan pagar una suscripción por resolver este trabajo.

La versión mínima que se puede vender necesita dos o tres tipos de aplicación aprobados, un formulario de entrada estructurado, un chat de v0 por aplicación de cliente, una pantalla de revisión con streaming, un proxy seguro para la previsualización y un botón de despliegue bajo control humano. La ventaja competitiva está en el modelo de datos, los permisos, las plantillas y la distribución del producto anfitrión.

La contrapartida es dura, pero útil: un wrapper genérico casi no tiene defensa. Si el producto no puede explicar qué sabe sobre el trabajo del cliente que v0 por sí solo desconoce, es mejor no construirlo.

2. Un generador de sitios web y campañas de marca blanca para agencias

Ofrece a la agencia un formulario de cliente con su propia marca, un conjunto fijo de tipos de página, su propia skill de sistema de diseño, una cola de revisiones y un proceso de entrega para el despliegue. Los clientes interactúan con la experiencia de la agencia, mientras v0 gestiona entre bastidores el espacio de trabajo y la previsualización en vivo.

ai website builder recibe unas 40,500 búsquedas mensuales en Google de Estados Unidos, con un crecimiento interanual del 49% según el conjunto de datos. Es el mayor volumen visible de esta investigación, pero también indica que el mercado está lleno de competidores capaces. La oportunidad no es «crear cualquier sitio web», sino «crear el tipo de sitio de esta agencia, con este stack, estos componentes y este proceso de aprobación».

Un MVP necesita una configuración de marca, tres patrones de página, carga de recursos, comentarios sobre la previsualización y aprobación del despliegue. El problema es el soporte: cuando el texto, el diseño, la accesibilidad o las integraciones generadas necesiten correcciones, los clientes responsabilizarán a la agencia, no a v0.

3. Un bot que convierte solicitudes de funcionalidades en previsualizaciones para equipos de producto

Convierte una incidencia aprobada en una propuesta funcional. Una GitHub App o un webhook interno importa el repositorio, inicia un chat asíncrono de v0, guarda el ID del chat y publica la previsualización en el ticket. Una persona la revisa antes de cualquier merge o despliegue.

Google registra unas 390 búsquedas mensuales en Estados Unidos para how to build an app with ai, y el conjunto de datos señala un crecimiento interanual del 86%. La demanda en asistentes de IA para build an app with ai alcanzó 392 prompts mensuales en julio de 2026. Esto respalda el interés por aplicaciones completas y funcionales, aunque no demuestra que exista un mercado independiente para CI. Plantea esta opción como una función de equipo o un complemento de una plataforma para desarrolladores, no como una propuesta self-service generalista.

El MVP se compone de un webhook, una lista de repositorios permitidos, un ejecutor de tareas asíncronas, un almacén para los chats de v0, una previsualización aislada y un estado de aprobación. El principal inconveniente es el riesgo. El código generado que se ejecuta en la previsualización no es confiable, el acceso al repositorio es sensible y una demo convincente no demuestra que las pruebas, la seguridad, las migraciones y los casos límite sean correctos. El despliegue en producción nunca debe ser la acción predeterminada.

Para entender mejor dónde encaja esta propuesta entre los agentes de programación y las herramientas que convierten prompts en aplicaciones, consulta las mejores herramientas de vibe coding en 2026.

Qué no resuelve la API de v0

La API aporta un agente que crea aplicaciones y su espacio de trabajo. El producto que lo rodea sigue siendo responsabilidad tuya.

• No decide qué se debe construir. Una petición ambigua puede producir una versión muy pulida de algo equivocado. El formulario inicial, las plantillas, las restricciones y los controles de revisión siguen siendo esenciales.
• No autoriza a tus clientes. El helper de previsualización reenvía el tráfico, pero tu aplicación debe decidir quién puede acceder a cada chat.
• No convierte el código generado en código confiable. Sirve las previsualizaciones desde un sitio exclusivo con un dominio registrable distinto y revisa el código antes de que llegue a producción.
• No traslada los chats de v1 a v2. Elige una versión de v1, descárgala como ZIP y crea un chat nuevo de v2 a partir de ese estado.
• No sustituye la API de Vercel. Las variables de entorno y varias operaciones del proyecto pertenecen al proyecto de Vercel asociado.
• No fija el costo. Los archivos de código fuente, el historial de la conversación, los prompts y la salida contribuyen al consumo de tokens.
• No es un motor local de creación de aplicaciones. Puedes ejecutar la integración localmente, pero el flujo documentado llama a la API alojada de v0 y ejecuta las previsualizaciones en la infraestructura de Vercel.

Mi conclusión: v0 tiene sentido cuando la previsualización funcional y la iteración con estado constituyen la ventaja del producto. Si solo necesitas un fragmento de código, un componente puntual o una transformación de archivos muy determinista, no compensa añadir un espacio de trabajo, un proxy, la contabilidad de créditos y toda la infraestructura de despliegue.

Si quieres un generador basado en v0, diseñado y preparado para producción según las necesidades de tu empresa, desarrollo sistemas de IA para producción.