Modelos y costes de API de Jan AI: endpoints locales, en la nube y personalizados

Los modelos en la nube de Jan AI no son modelos de Jan. Jan no aloja ningún servicio de inferencia ni vende nada, por lo que "modelos en la nube" en Jan Desktop significa once puentes integrados que requieren tu propia clave hacia proveedores externos, además de cualquier endpoint con formato OpenAI o Anthropic que añadas tú mismo: cada uno es facturado por quien esté al otro lado. La aplicación en sí es gratuita: jan.ai/pricing devolvía HTTP 404 al comprobarla el 19 de septiembre de 2026, y ni Jan Desktop ni Jan Agent documentan ningún plan, puesto, crédito o cuota. Por tanto, el único número que merece la pena presupuestar son los tokens a la tarifa de tu proveedor, o nada por solicitud si el modelo se ejecuta en tu propia máquina.

Primero, una aclaración, porque las búsquedas los mezclan. Janitor AI (janitorai.com) es un sitio de chat con personajes para consumidores y un producto completamente distinto; una gran parte de las búsquedas de "jan ai api key" se refiere a su clave de proxy. Si eso es lo que estás configurando, empieza por la configuración de Janitor AI; en esta página no aparece ningún precio ni límite para ese producto.

Tres productos comparten la marca Jan, y dos comparten el nombre del binario

Confundirse aquí es la razón por la que los compradores llegan sin saber si Jan es gratuito para ejecutar. jan.ai enumera exactamente tres productos (página de inicio consultada el 18 de septiembre de 2026):

• Jan Desktop —la aplicación estable con prioridad local. Última versión etiquetada v0.8.4, publicada el 23 de julio de 2026; el repositorio no está archivado y recibió su último push el 18 de septiembre de 2026, con 44,551 estrellas (API de GitHub, 19 de septiembre de 2026). Incluye los motores llama.cpp y MLX y puede acceder opcionalmente a proveedores en la nube. El repositorio se describe a sí mismo como ejecutable 100% sin conexión.
• Jan Agent —un agente de terminal independiente, distribuido por separado. Su inicio rápido incluye una advertencia de vista previa: el instalador de dev obtiene el canal agent-nightly. No tiene ninguna versión etiquetada en el repositorio y el inicio rápido solo muestra una mediante jan --version, por lo que cualquier información que anotes sobre sus indicadores corresponde específicamente a la compilación que instalaste.
• Tokamak —un backend autoalojado a nivel de organización con su propio dominio de documentación. Su página no publica ningún precio, plan, número de puestos, crédito ni lista de espera, por lo que esta página no cita ninguno; que no haya términos publicados no equivale a que sea gratuito. Es un backend autoalojado independiente, no un plan de pago añadido a Jan Desktop, y jan login es la ruta documentada para acceder a él.

La documentación propia de Jan parece contradictoria aquí, y la página de proveedores es la que lo reconcilia. El texto de la página de documentación describe Jan Agent como un sistema que lanza agentes contra un modelo local; el inicio rápido afirma claramente que Jan Agent no tiene motor de inferencia local: llama a un proveedor remoto. Ambas afirmaciones son correctas respecto de cosas distintas. El Agent no ejecuta ningún modelo por sí mismo, por lo que un modelo siempre se ejecuta en otro lugar, pero ese lugar puede ser tu propia máquina: la página de proveedores tiene una sección "Your own hardware" que dirige el Agent al servidor API local de Jan Desktop (http://localhost:6767/v1) y afirma que nada sale de tu máquina en esa configuración. Por tanto, el Agent siempre necesita un endpoint, pero no siempre uno de pago.

La colisión de nombres lo complica aún más. La propia CLI de Jan Desktop (disponible desde 0.7.8) y el binario de Jan Agent se invocan ambos como jan, con conjuntos de comandos diferentes. Por tanto, existen tres "endpoints de Jan" distintos: 127.0.0.1:1337 para el servidor API local de la interfaz gráfica de Desktop, localhost:6767/v1 para jan serve desde la CLI de Desktop y cualquier URL base remota a la que apunte un proveedor.

Precios de Jan AI: cuánto cuesta el software y qué te factura

Una nota sobre la licencia, porque la lectura automática es incorrecta: la API de GitHub informa NOASSERTION para este repositorio, porque el archivo LICENSE es un preámbulo personalizado de Menlo Research seguido del aviso estándar de Apache 2.0 y una solicitud de atribución, en lugar del texto literal de Apache 2.0 que busca un escáner. El propio archivo dice "Licensed under the Apache License, Version 2.0", así que esa es la licencia, no el campo de la API.

Los once proveedores en la nube integrados y lo que realmente son

Jan Desktop inicializa cada proveedor integrado con una URL base en web-app/src/constants/providers.ts. Todos apuntan a un tercero. No existe ninguna entrada jan ni menlo.

Leído de ese archivo el 18 de septiembre de 2026. Observa el patrón que siguen todos: la ruta de versión forma parte de la URL base. Esa única convención es la causa más común de errores de configuración en Jan y se explica más abajo.

Tres cosas distintas llamadas "clave de API de Jan AI"

Los dos significados realmente chocan dentro de Jan, porque su servidor local refleja ambos formatos de red. La documentación de preferencias de API de Jan muestra que el servidor local expone GET /v1/models, POST /v1/chat/completions y un POST /v1/messages compatible con Anthropic autenticado con x-api-key. Esa es la misma forma que expone un gateway remoto, por lo que el mismo comando curl puede dirigirse a tu portátil o a un endpoint de pago, y solo el host indica cuál es cuál.

Local o nube: decide según la memoria, el contexto y la necesidad de trabajar sin conexión

La base más objetiva para esta decisión la publica el propio Jan en la página de instalación para Mac (macOS 13.6 o superior, solo Apple Silicon —los Mac Intel no son compatibles— y más de 10GB de espacio libre):

Los mínimos de Windows se indican por separado en la página de instalación de Windows e incluyen un mínimo de VRAM: Windows 10 o superior, 8GB de RAM como mínimo y 16GB recomendados, 6GB de VRAM como mínimo para GPU NVIDIA, AMD o Intel Arc, 10GB de espacio libre y compatibilidad con AVX2. Esa página no publica ninguna tabla de RAM por tamaño de modelo. Los requisitos de Linux no se comprobaron para esta página. Dentro de la aplicación, el Hub sustituye las cifras por un veredicto — una etiqueta de color que indica Fits, May be slow o Won't fit según el nivel de cuantización — y afirma que no se descarga ningún dato para determinar el estado de compatibilidad.

Sobre la elección del modelo: Jan documenta siete modelos propios — Jan-v3-4B, Jan-Code-4B, Jan-v1, Jan-v2-VL-med, Jan-Nano-32, Jan-Nano-128 y Lucy — con pesos abiertos en Hugging Face bajo las organizaciones propias de Jan, janhq y Menlo. No todos tienen el mismo tamaño: la documentación de modelos indica 4B parámetros para Jan-v3-4B y Jan-v1, 8B para Jan-v2-VL-med y 1.7B para Lucy. Jan-v3-4B también ofrece un contexto nativo de 262,144 tokens, y su página expone claramente su propio límite: los 4B parámetros limitan el razonamiento complejo de varios pasos en comparación con modelos más grandes. Esa frase resume en una línea todo el argumento entre local y nube. Usa local para trabajos acotados y privacidad; pasa a remoto cuando la tarea supera el número de parámetros o tu memoria.

API personalizada de Jan Desktop: añadir un endpoint con formato OpenAI o Anthropic

La ruta documentada es Settings → Model Providers → Add Provider. La página de endpoints personalizados de Jan (comprobada el 19 de septiembre de 2026) ofrece exactamente dos formatos de comunicación — compatible con OpenAI, descrito como destinado a vLLM, Ollama, LocalAI, TGI, servidor llama.cpp y LiteLLM en modo OpenAI, y compatible con Anthropic, para endpoints que exponen la API Anthropic Messages — y después solicita un nombre de proveedor, una URL base y una clave de API. El campo de clave es obligatorio incluso para servidores locales sin clave, donde sirve cualquier marcador de posición.

Dos detalles determinan si funciona al primer intento.

La ruta de versión pertenece a la URL base. La documentación de Jan la identifica como el error común con esas palabras: introducir http://localhost:8000 en lugar de http://localhost:8000/v1, lo que produce un 404 en cada solicitud. Para un proveedor con formato OpenAI dirigido a Kunavo, eso significa https://api.kunavo.com/v1.

Para el formato Anthropic, la documentación de Jan no establece una regla — indica que se use la base que documente tu gateway, y su único ejemplo es una instancia local de LiteLLM. El código fuente de Jan lo aclara: la ruta Anthropic se basa en el proveedor Anthropic del Vercel AI SDK, cuya URL de solicitud se construye como {baseURL}/messages con una cabecera x-api-key, y cuya base predeterminada incluye el prefijo de versión. Por tanto, el mismo https://api.kunavo.com/v1 es el valor que debes introducir, y la solicitud llegará a /v1/messages. Esto es una lectura de dos bases de código, no una prueba, así que considéralo el primer valor que debes probar — consulta la nota no probada al final de esta página.

Esa distinción confunde a algunas personas, porque la propia guía de ANTHROPIC_BASE_URL de Kunavo dice lo contrario para otra familia de clientes: los SDK oficiales de Anthropic y Claude Code añaden /v1/messages por sí mismos, por lo que usan el origen sin más; añadir /v1 produce /v1/v1/messages y un 404. El proveedor con formato Anthropic de Jan no es uno de esos clientes. Si ves un 404, la ruta duplicada en el error indica qué convención estás usando. El endpoint Messages de Kunavo acepta tanto la cabecera Anthropic x-api-key como Authorization: Bearer, y el endpoint de finalizaciones de chat cubre la ruta con formato OpenAI.

Descubrimiento de modelos y capacidades. Jan intenta obtener los modelos disponibles desde {base_url}/models al guardar; si falla, escribes el id del modelo exactamente como lo espera tu servidor. Kunavo ofrece una lista de modelos en ese mismo prefijo, por lo que el descubrimiento debería funcionar en la ruta con formato OpenAI — no está documentado ni probado si Jan lo consulta para un proveedor con formato Anthropic, así que prepárate para añadir el id manualmente. Más importante aún: las capacidades de los proveedores personalizados no se detectan automáticamente. Jan afirma que no puede inferir si un modelo admite herramientas, visión o audio, y te indica que añadas cada modelo manualmente y configures sus capacidades por modelo. Su documentación de MCP muestra el otro lado: para un proveedor integrado como Anthropic, Jan lee automáticamente las capacidades de los modelos del proveedor una vez que añades la clave, y la propia entrada de solución de problemas para «el modelo no usa los MCP que habilité» indica que hay que comprobar que el modelo tenga las herramientas habilitadas. Ninguna de las dos páginas especifica cuál es el valor predeterminado de un modelo personalizado recién añadido, así que comprueba Model Capabilities antes de asumir que MCP está activo. Esa es la mayor diferencia práctica entre pegar una clave en el proveedor Anthropic integrado y añadir un gateway como proveedor personalizado.

La aplicación también muestra un campo Base URL en algunos proveedores integrados, lo que permitiría redirigir la entrada Anthropic u OpenAI integrada a un gateway. Ninguna página de documentación de Jan cubre esto, y esta página no ejecutó la aplicación para confirmarlo — considera el flujo Add Provider como la ruta compatible.

Jan Agent acepta los mismos dos formatos mediante flags

La documentación de proveedores del Agent configura el endpoint con --provider, --api-key, --base-url, --model (repetible) y --api-type, siendo este último el protocolo de comunicación, ya sea openai o anthropic, con OpenAI-compatible como valor predeterminado.

# Jan Agent is a preview build from a nightly channel.
# Re-check these flags against your own `jan config --help` before relying on them.
jan config set \
  --provider kunavo \
  --api-type anthropic \
  --base-url https://api.kunavo.com/v1 \
  --api-key sk-kn-... \
  --model claude-sonnet-4-6

La configuración se guarda en ~/.jan/config.toml, con una sustitución por proyecto en agent.toml bajo [provider] y una temporal mediante JAN_API_KEY. La precedencia está documentada en el propio código fuente, en providers.rs: la configuración global es la base, los ajustes de Desktop se incorporan como una fuente de solo herencia que nunca la sobrescribe, el archivo del proyecto prevalece sobre ambas, y los flags de la CLI más las variables de entorno prevalecen sobre todo. Ambas interfaces de Jan también aceptan varias claves por proveedor y reintentan con la siguiente, y ambas limitan ese reintento de la misma manera: la página de endpoints personalizados de Jan Desktop documenta un fallback solo para HTTP 401, 403 o 429; los demás errores no se reintentan, y el código fuente del Agent aplica los mismos tres estados. El mensaje key rotation exhausted pertenece a Jan Desktop, y su página de solución de problemas lo interpreta como que todas las claves configuradas han fallado con 401 o 403, no solo una.

Si auditas el repositorio por tu cuenta, te encontrarás con una trampa aquí: un comentario sobre stream_openai_chat_completions en core/agent/upstream.rs dice que api_type «es None para todos los invocadores actualmente» y que el agente siempre se ha comunicado mediante /chat/completions de OpenAI independientemente de su valor. Ese comentario describe una función auxiliar y está desactualizado respecto al resto: core/agent/loop.rs llama a resolve_api_type_for_model y construye un conversor a partir de su resultado, y ese conversor reescribe la solicitud para enviarla a /messages con x-api-key y una cabecera anthropic-version fija (converters.rs). Por tanto, --api-type anthropic sí se respeta, y el propio comentario de ese mismo conversor dice que el base_url registrado debe incluir el prefijo de versión, por lo que el fragmento anterior termina en /v1.

Cuando falla

Las tres primeras filas proceden de la página de solución de problemas de Jan; las dos últimas, de la página de endpoints personalizados. Los registros de la aplicación se encuentran en ~/Library/Application Support/Jan/data/logs/app.log en macOS, %APPDATA%\Jan\data\logs\app.log en Windows y ~/.local/share/Jan/data/logs/app.log en Linux. La referencia de errores de Kunavo cubre los mismos códigos de estado desde el lado del gateway.

Un presupuesto de nube calculado para Jan

Estas cifras son aritmética ilustrativa de tokens, no costes medidos de tareas ni un límite máximo de facturación. La columna de chat supone un día en Jan Desktop de aproximadamente 40 turnos en los que el hilo creciente se reenvía cada vez — 240,000 tokens de entrada y 20,000 de salida. La columna del agent supone una sesión más larga con uso de herramientas, con 400,000 tokens de entrada y 30,000 de salida. Ambos recuentos de tokens son un modelo propio de esta página, no cifras publicadas por Jan. Ambos suponen que no hay lecturas de caché, porque no se rastreó si el almacenamiento en caché de prompts sobrevive a un proveedor personalizado en ninguna de las dos interfaces de Jan. Las tarifas son precios actuales del catálogo de Kunavo por millón de tokens.

Dos interpretaciones. Primero, la diferencia entre el modelo más barato y el más caro de esa tabla es de aproximadamente 5.0x para la misma sesión supuesta — un rango lo bastante amplio como para que el modelo que elijas sea la palanca que conviene accionar primero, y un argumento a favor de una ruta que permita cambiar de modelo sin abrir una cuenta nueva. Segundo, compara honestamente esos totales con la opción local: un modelo que cabe en la tabla de RAM anterior cuesta $0 por solicitud, y Jan proporciona el motor para ejecutarlo. Para un usuario de Jan Desktop, la factura remota es una elección sobre las capacidades, no un coste por usar la aplicación.

Escala estas cifras según tus propios días antes de considerar cualquiera de ellas un presupuesto. El importe del catálogo de Kunavo es un mínimo de facturación, no un límite máximo: cuando el proveedor ascendente informa de su cargo, la factura es el mayor entre el coste del catálogo y el coste del proveedor ascendente multiplicado por el margen aplicable. La recarga mínima es de $10 en crédito prepago — un mínimo de financiación, no una tarifa por tarea ni una suscripción. Consulta los detalles de facturación y la optimización de costes de IA para conocer el método de medir y elegir.

Qué ruta gana en cada caso

Si la fila del gateway es la que estás evaluando, el directorio de clientes indica cómo cada cliente de escritorio y agent gestiona las URL base y los formatos de comunicación, y la API compatible con OpenAI cubre la convención que sigue el primer formato de Jan.

Configurarlo y comprobar la primera factura

Todo lo anterior procede de la documentación y el código fuente publicados por Jan, además de la documentación propia de Kunavo. Kunavo no ha probado Jan Desktop ni Jan Agent en tiempo de ejecución: no se envió ninguna solicitud mediante ninguna de las dos aplicaciones para esta página, por lo que nada de lo aquí indicado afirma que las llamadas a herramientas, el streaming o el descubrimiento de modelos hayan superado una prueba de extremo a extremo. Considera las URL base como lo que implican ambos conjuntos de documentación y confírmalas tú mismo con una tarea acotada. Mantén disponible una ruta funcional mientras lo pruebas, envía una solicitud pequeña y después lee el cargo que tu cuenta haya registrado realmente, en lugar de cualquier estimación de esta página. Crea una cuenta de Kunavo cuando estés listo para financiar una clave.

Preguntas frecuentes

Comprobado de nuevo el 21 de septiembre de 2026: la URL de precios (sigue devolviendo 404), el repositorio de GitHub y su última versión (v0.8.4), la página de inicio, la página de Tokamak, la documentación de endpoints personalizados, servidor de API, referencia de API, MCP, instalación en Mac, instalación en Windows, Hub y solución de problemas, la guía de inicio rápido y la documentación de proveedores del Agent, la documentación de los modelos propios, las organizaciones de Hugging Face y los archivos de código fuente de constantes de proveedores, convertidor, upstream del agent y bucle del agent. Las cifras de estrellas y del último push proceden de la API de GitHub del 19 de septiembre de 2026 y cambian a diario. No se comprobaron en absoluto: los requisitos del sistema Linux, las condiciones comerciales de Tokamak y el comportamiento del almacenamiento en caché mediante un proveedor personalizado. Las tarifas de tokens de Kunavo proceden del catálogo actual, y cada cifra en dólares aquí es aritmética ilustrativa de tokens, no un coste medido de una tarea.