Convex

¿Qué es Convex?

Convex es un backend reactivo que combina una base de datos, funciones de servidor y bibliotecas cliente. Sus consultas son código TypeScript ejecutado junto a la base de datos, y los resultados suscritos reaccionan a cambios en los datos guardados.

La base de datos en tiempo real de Convex usa un modelo relacional y almacena documentos similares a JSON. Los esquemas son opcionales, los documentos pueden referenciar los de otras tablas y la aplicación lee y escribe con una API de JavaScript, no SQL.

Convex también ofrece acceso gestionado a modelos de IA mediante AI Gateway. Las acciones del backend llaman al servicio; Convex conserva las credenciales de proveedores y los tokens de acceso de corta duración se limitan a un despliegue.

Funciones principales

Consultas, mutaciones y acciones

Cada tipo de función tiene sus límites de ejecución:

• Las consultas leen datos, se almacenan en caché y admiten suscripciones reactivas.
• Las mutaciones escriben datos y se ejecutan como transacciones de base de datos.
• Las acciones llaman a API externas. No son transaccionales ni se guardan en caché.
• Las acciones HTTP exponen puntos de acceso para webhooks o clientes personalizados.

Acceso gestionado a modelos

AI Gateway ofrece rutas para generación de texto, embeddings, decisiones, imágenes, vídeos, generación de voz y transcripción. Decisions, Voice y la generación de imágenes y vídeos están en fase alfa; pueden cambiar los formatos de solicitud y respuesta.

Guía

Conectar una interfaz React

Un backend Convex existente se conecta a React con estos elementos:

1. Crea un ConvexReactClient para el despliegue y pásalo a un ConvexProvider que envuelva el árbol de componentes.
2. Lee los datos del backend con useQuery y el objeto api generado. El comando de desarrollo genera el objeto en convex/_generated/api.js, con autocompletado de JavaScript y tipos TypeScript de extremo a extremo.
3. Modifica datos con useMutation. El hook devuelve una función asíncrona; llamarla con sus argumentos ejecuta la mutación.

Casos de uso de Convex

• Interfaces de chat en vivo: Convex ofrece un tutorial de chat en tiempo real con mensajes persistentes y actualización en vivo.
• Recuperación semántica y recomendaciones: la búsqueda vectorial encuentra documentos similares al vector dado. Sus usos documentados incluyen contexto para aplicaciones LLM y recomendaciones de contenido relacionado.
• Agentes persistentes: el componente Agent guarda el historial de conversación entre sesiones y separa el trabajo de IA prolongado de una interfaz reactiva. Admite búsqueda híbrida vectorial y textual del historial y ampliación de prompts con RAG desde otras fuentes mediante el componente RAG o una implementación propia.
• Trabajo diferido y recurrente: las funciones programadas se ejecutan una vez después; los trabajos cron se repiten. Ejemplos: correos de bienvenida y conciliación de cuentas; Workpool y Workflow añaden colas o flujos duraderos con reintentos y demoras.

Para quién es

• Desarrolladores de aplicaciones JavaScript y TypeScript: el backend TypeScript también acepta JavaScript; las funciones se exponen por las API de las bibliotecas cliente, para equipos que llevan código de interfaz y servidor.
• Equipos que buscan operación alojada: Convex presenta su producto alojado como una opción con menos intervención; el autoalojamiento ejecuta el código actual del backend en servidores propios del equipo.

Plataformas

• Clientes React: ConvexReactClient usa WebSocket para enviar resultados sin sondeo y reconecta tras perder la conexión.
• Alojamiento del frontend: el frontend puede usar Vercel, Netlify o alojamiento personalizado, por separado del despliegue del backend.
• Autenticación: las conexiones y llamadas usan JWT de OpenID Connect. Convex Auth admite registro e inicio de sesión en el cliente con React y React Native, pero sigue en beta y tiene menos funciones que integraciones de terceros.
• Regiones de datos: los despliegues pueden usar Virginia del Norte, Irlanda, Sídney o Canadá Central. Fuera de EE. UU. se aplica un recargo del 30 % (1,3 veces la tarifa estándar).

Toda la infraestructura del despliegue se aloja en la región elegida. Cambiar de región exige un nuevo proyecto o despliegue y exportar e importar datos; no se puede trasladar directamente el despliegue existente.

Precios

Precios recopilados el 2 de noviembre de 2026 en USD, con la referencia mostrada del este de EE. UU. Los recursos incluidos se comparten entre regiones.

Planes y acceso para desarrolladores

Business indica un mínimo mensual de $2,500; publica por separado las tarifas unitarias de clase de despliegue e infraestructura. Enterprise indica descuentos por compromiso anual sin cuantía ni total anual.

Recursos de Free, Starter y Professional

Cada celda muestra la cantidad incluida y la tarifa adicional. En la primera columna, los excesos de pago corresponden a Starter; Free tiene asignaciones fijas. El almacenamiento se factura por GB/mes; los demás recursos según sus unidades.

El cómputo sin servidor de consultas y mutaciones es gratuito. Las llamadas incluyen llamadas de clientes, programaciones, actualizaciones de suscripción y accesos a archivos. El almacenamiento de archivos incluye copias; la salida incluye accesos a archivos desde funciones y generación o restauración de copias. Los índices y consultas de texto y vectores comparten sus medidores respectivos.

El uso se suma entre los proyectos del equipo, sin asignarlo por proyecto o desarrollador. Un exceso prolongado de Free puede causar errores HTTP, pero Convex afirma que nunca elimina registros de mutaciones escritos correctamente por superar recursos. La FAQ menciona Starter y también usa «Starter Plus» para el tráfico continuado. Estas etiquetas no implican un nivel con precio independiente.

Tarifas de despliegue de Business y Enterprise

La tabla mensual del este de EE. UU. enumera cuatro clases; los despliegues activos se prorratean diariamente. Otras unidades figuran en cada fila.

Estos medidores de infraestructura se aplican junto a la clase de despliegue:

El guion conserva el valor publicado sin implicar precio cero ni derecho incluido.

Cargos de IA y controles de gasto

AI Gateway requiere un equipo de pago y admite despliegues de producción o desarrollo en la nube, o locales vinculados a un proyecto. Los despliegues Free y autoalojados no pueden usarlo; las acciones autoalojadas pueden llamar a proveedores con sus propias claves.

Los costes dependen del modelo, el momento, los tokens en caché, la resolución y duración de imágenes o vídeos, o los caracteres, segundos o tokens de voz. Aparecen en la factura de Convex; cancelar una solicitud de vídeo enviada aún puede generar costes de generación.

Los despliegues en la nube admiten umbrales diarios y mensuales de AI Gateway que desactivan todo el despliegue, no solo las solicitudes a modelos; los despliegues que no son de desarrollo también admiten umbrales de aviso. Las solicitudes locales vinculadas a un proyecto comparten el límite de gasto del equipo; las solicitudes en curso o las que usan credenciales de corta duración ya emitidas pueden completarse después de alcanzarlo.

Renovación y reembolsos

Las tarifas no son cancelables ni reembolsables salvo excepciones contractuales expresas. Los Order Forms fijan ciclos mensuales o anuales; los excesos de autoservicio se cobran automáticamente y puede haber cargos intermedios al alcanzar un umbral de factura.

Las suscripciones de Order Form se renuevan automáticamente por igual plazo salvo aviso de no renovación de cualquiera de las partes al menos 60 días antes del vencimiento. Si el cliente decide no renovar automáticamente, la suscripción pasa a ser mensual con condiciones y precios vigentes; cualquiera de las partes puede terminarla con aviso previo por escrito de 30 días.

Si Convex no subsana un incumplimiento sustancial en los 30 días posteriores a recibir aviso escrito, el cliente, si es la parte no infractora, puede terminar por escrito el acuerdo o los Order Forms afectados. Si el cliente termina el acuerdo bajo esta disposición, Convex reembolsa la proporción de tarifas prepagadas no usadas del plazo restante de los Order Forms terminados a la fecha efectiva de terminación. Es una excepción contractual, no un plazo general de reembolso de pruebas.

Alternativas a Convex

Supabase ofrece Postgres por proyecto, autenticación, almacenamiento con Row Level Security, servicios en tiempo real y Edge Functions. Su base Postgres es relevante para equipos orientados a SQL.

Firebase Cloud Firestore ofrece una base de datos NoSQL para móviles, web y servidores, con escuchas en tiempo real y soporte sin conexión para móviles y web. Ese comportamiento sin conexión documentado aborda el acceso desconectado; no demuestra que Convex funcione igual.

Limitaciones

Límites de transacción y ejecución

• Efectos externos: las acciones no se reintentan automáticamente al fallar: una solicitud externa ya podría haber surtido efecto. Quien llama gestiona los reintentos; las promesas pendientes pueden completarse o no tras el retorno.
• Transacciones separadas: las acciones acceden a la base de datos indirectamente mediante consultas y mutaciones. Las llamadas separadas a runQuery/runMutation no siempre comparten un estado coherente; una consulta o mutación combinada tiene un límite transaccional coherente.
• Tamaño de documento: un documento tiene un límite de 1 MiB y profundidad de anidamiento de 16.
• Tamaño de transacción: una consulta o mutación puede leer como máximo 16 MiB y escribir como máximo 16 MiB. Los datos examinados y luego filtrados siguen contando como lecturas.

La guía indica que las acciones agotan el tiempo de espera a los 10 minutos. La referencia de límites enumera, en cambio, 30 minutos para acciones del runtime Convex y 10 minutos para las del runtime Node, además de un segundo de código de usuario de consulta o mutación sin contar operaciones de base de datos. Las descripciones públicas no coinciden.

Límites de búsqueda y generación

La búsqueda vectorial es aproximada de vecinos más cercanos, exclusiva de acciones, y usa similitud coseno. La pertenencia no es reactiva, aunque otra consulta puede mantener reactivos los datos de cada resultado; los registros pueden cambiar o desaparecer antes de recuperarse. Cada tabla permite cuatro índices vectoriales de 2 a 4.096 dimensiones.

La generación de imágenes y vídeos está en alfa; sus formatos de solicitud y respuesta pueden cambiar. Las imágenes usan prompts de texto, sin edición con imágenes de entrada o máscaras. El vídeo síncrono falla tras unos cinco minutos y permite descargas de 64 MiB; la cancelación, el tiempo de espera o la pérdida de respuestas aún pueden generar costes. Las operaciones asíncronas caducan a los siete días; los proveedores pueden conservar los vídeos menos tiempo.

Licencia de autoalojamiento

La licencia de código justo FSL Apache 2.0 del backend excluye crear un producto diseñado para competir con Convex Cloud alojado. El código pasa a Apache 2.0 dos años después de crearse; las versiones actuales no son Apache 2.0 sin restricciones desde el primer día.

Las Beta Features designadas son solo para evaluación, están fuera de la Platform contractual y no tienen compromisos de servicio, soporte, garantía ni responsabilidad por su uso; Convex puede discontinuarlas.

Derechos sobre datos y tratamiento por modelos

Clientes o licenciantes conservan los derechos sobre Customer Data y conceden a Convex una licencia limitada de tratamiento para entrega de la plataforma, mantenimiento, soporte y mejora, integraciones iniciadas por el cliente y obligaciones legales. Es una licencia del cliente a la plataforma, no una cesión de propiedad de datos.

Convex posee Aggregated Data y puede usarlos para fines comerciales legítimos, incluidos análisis, desarrollo de productos y comparativas. No deben identificar a clientes o usuarios, contener su información de forma identificable ni permitir razonablemente su reidentificación.

Las condiciones de IA prohíben entrenar o mejorar modelos fundacionales de Convex o terceros con Customer Data sin consentimiento previo por escrito del cliente. Entradas similares pueden producir resultados similares, sin garantía de exactitud, integridad, ausencia de errores o adecuación al fin.

Un marcador ZDR registra la coincidencia con el catálogo de retención cero en la última actualización. El enrutamiento debe activarse por solicitud y falla sin un punto de acceso elegible; el marcador no es garantía. Las rutas de imagen, vídeo y audio no aceptan esta opción.

Privacidad, eliminación y lugares de tratamiento

La política de privacidad de Convex excluye los Customer Data de aplicaciones, regidos por acuerdos del cliente y políticas de las aplicaciones. Para datos bajo su política, Convex puede recopilar identificadores de IP o dispositivo, ubicación aproximada y actividad, y usar cookies y herramientas de análisis.

La información cubierta por la política puede tratarse o almacenarse en todo el mundo, incluido EE. UU., y conservarse durante el uso del servicio o para fines de recopilación, prestación, disputas, auditorías, defensa jurídica, fines comerciales, ejecución y obligaciones legales; no se indica un plazo fijo universal.

Según el DPA, Convex debe eliminar Customer Personal Data al vencer o terminar el acuerdo. Las copias de respaldo o archivo se eliminan según su calendario de conservación; las copias retenidas por obligación legal deben aislarse y protegerse de nuevos tratamientos salvo los exigidos por la ley aplicable. La lista de subencargados vincula infraestructura y base de datos a la región elegida, y enumera soporte, análisis, facturación y enrutamiento de IA en EE. UU. y gestión comunitaria en Alemania.

Convex declara cifrado AES-256 en reposo para código de clientes, bases de datos, archivos e índices de búsqueda, cifrado en tránsito, acceso restringido a producción y cumplimiento SOC 2 Type 2. Convex afirma que las empresas sujetas a HIPAA pueden tratar PHI en la plataforma si firman su Business Associate Agreement; estas afirmaciones del proveedor no prueban el cumplimiento de cada aplicación del cliente.

Preguntas frecuentes

Q1. ¿Todas las funciones de Convex tienen garantías de tiempo real y transacción?

No. Las consultas tienen caché y suscripciones y las mutaciones son transaccionales; las acciones externas no heredan esas mismas garantías.

Q2. ¿AI Gateway está incluido en el plan Free?

No. Requiere un equipo de pago y el uso de modelos se mide por separado. Los despliegues autoalojados usan credenciales propias del proveedor.

Q3. ¿Elegir una región europea significa que todos los tipos de datos permanecen allí?

No. La infraestructura de despliegue, los datos personales cubiertos por la política, los subencargados y la retención del enrutamiento de modelos tienen ámbitos distintos.