Documentación

Documentación

Janitor AI

La configuración del proxy de Janitor AI requiere la URL completa del endpoint, no una URL base: la ruta termina en /chat/completions. Si introduces correctamente ese campo, el resto son un nombre, un id de modelo y una clave.

API Settings → Proxy → Add Configuration: Proxy URL es la ruta completa /v1/chat/completions y Model Name debe ser exactamente un ID del catálogo.

Janitor AI · Configuración de API
☰ → API Settings → Proxy → + Add Configuration

  Config Name   Kunavo
  Model Name    claude-sonnet-5
  Proxy URL     https://api.kunavo.com/v1/chat/completions
  API Key       sk-kn-...
La URL del proxy es una URL de endpoint completa. La guía oficial de Janitor AI indica que debe terminar en /chat/completions, así que en este caso es https://api.kunavo.com/v1/chat/completions; no es la URL base que pegarías en una herramienta de programación. Pegar aquí una URL base es la causa más habitual de que «el proxy no funcione».
El nombre del modelo debe ser exacto. Janitor AI envía la cadena sin modificar, así que un error tipográfico o un nombre para mostrar provoca un error del endpoint, en lugar de un mensaje útil en la interfaz. Copia los ids de GET /v1/models o de /models en este sitio.
¿Aún no tienes una clave? Crea una cuenta de Kunavo, genera una clave (empieza por sk-kn-) y añade crédito desde $10; las llamadas se pagan con ese saldo y las llamadas fallidas no se facturan. El panel se abre entonces en la configuración de Janitor AI.

Paso a paso

  1. Cree una clave en /app/keys y cópiela: se muestra una sola vez.
  2. Abre cualquier chat, haz clic en el menú ☰ de la parte superior y elige API Settings.
  3. Selecciona Proxy y luego + Add Configuration.
  4. Rellena Config Name, Model Name, Proxy URL y API Key exactamente como se indica arriba y guarda.
  5. Envía un mensaje. Si recibes una respuesta, el proxy funciona; si aparece un error que menciona el modelo, el problema está en Model Name; si menciona la URL, está en la ruta.

Comprobado con Guía oficial de Janitor AI sobre el proxy el 6 de septiembre de 2026. La configuración de terceros puede cambiar; si el nombre de un campo ya no coincide con lo que ves, esa página es la autoridad, no esta.

Verifica antes de depurar el cliente

Una solicitud determina si el fallo está en el endpoint, la clave o el archivo de configuración. Si devuelve JSON, la misma URL base y la misma clave funcionan en Janitor AI.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Qué ID de modelo introducir en el campo

Todos los modelos de texto están disponibles mediante un ID de modelo; la lista activa está en GET /v1/models, y el catálogo con precios está en la página de modelos. Las tarifas son USD por 1M de tokens, entrada / salida.

ID de modeloEntrada / salida de KunavoDónde encaja en Janitor AI
claude-sonnet-5$1.40 / $7.00la opción predeterminada: el equilibrio que busca la mayoría
claude-haiku-4-5$0.70 / $3.50el menor costo por turno y gran velocidad
claude-opus-5$3.50 / $17.50la opción cara; comprueba el coste por turno antes de comprometerte
gpt-5-6-terra$0.70 / $4.20conversaciones largas, cuando el tamaño del contexto es la limitación
La facturación es por token desde un saldo prepago, sin cuota mensual; consulta facturación. Con contexto repetido —que constituye la mayor parte de lo que envía un editor o cliente de chat—, la caché de indicaciones cambia más la factura que la elección del modelo.

Preguntas frecuentes

¿Qué URL de proxy necesita Janitor AI?

El endpoint completo de chat completions, no una URL base. La guía oficial de Janitor AI indica que la URL debe terminar en /chat/completions y ofrece como ejemplo una ruta completa; por tanto, para un servicio compatible con OpenAI es https://<host>/v1/chat/completions. Introducir la URL base es la razón más frecuente por la que un proxy configurado correctamente no devuelve nada.

¿Cómo configuro un proxy personalizado en Janitor AI?

Abre un chat, haz clic en el menú ☰, elige API Settings, selecciona Proxy y haz clic en + Add Configuration. Rellena Config Name, el Model Name exacto, Proxy URL con la ruta terminada en /chat/completions y API Key; luego guarda y envía un mensaje de prueba. Si recibes una respuesta, los cuatro campos son correctos.

¿Por qué Janitor AI dice que no encuentra el modelo?

Porque el Model Name se envía al endpoint tal cual y debe coincidir exactamente con un id de modelo real: los nombres para mostrar, las diferencias entre mayúsculas y minúsculas y los espacios finales provocan errores. Copia el id de la lista de modelos del proveedor o de una llamada GET /v1/models, en lugar de escribirlo de memoria.

¿Usar un proxy en Janitor AI cuesta dinero?

Cuesta lo que cobre el endpoint detrás del proxy. Janitor AI no cobra por el uso del proxy; el proveedor de API cobra por token por cada mensaje que envía la conversación. En un chat de rol largo, eso incluye todo el historial en cada turno. Elegir un modelo más barato y un endpoint con almacenamiento en caché de prompts es lo que mantiene baja la factura.