Solución de problemas
'Invalid API key' al hacer clic en Test
'Invalid API key' al hacer clic en Test
- Copia la clave sin espacios adicionales, comillas ni saltos de línea al final.
- Confirma que la facturación esté habilitada y que la cuenta tenga créditos.
- Para las claves del GLM Coding Plan / Kimi Code Plan, asegúrate de que la base URL coincida con el plan: las claves de suscripción no funcionan en el endpoint de la Developer API y viceversa.
'Model not found' al hacer clic en Test
'Model not found' al hacer clic en Test
- Test envía una solicitud real al modelo, así que un ID de modelo incorrecto o mal escrito falla aquí. Esto es lo esperado y es mejor que fallar al momento de la revisión.
- Copia el ID exacto del modelo desde el panel del proveedor. Algunos proveedores usan rutas profundas (p. ej., Fireworks
accounts/fireworks/models/kimi-k2p7-code) o escriben las versiones de otra forma (k2p7vsk2.7).
'Endpoint not found' al hacer clic en Test
'Endpoint not found' al hacer clic en Test
- Verifica que la URL base coincida exactamente con la del proveedor (la barra final importa en algunos).
- Para los proveedores compatibles con OpenAI, el endpoint suele ser
{baseURL}/chat/completions(Kodus agrega la ruta), así que pega la URL base sin ella. Una URL que termina en/chat/completions,/messageso/responsesse rechaza, y el mensaje indica la dirección que debes usar. - Un
404en una URL de OpenAI o compatible con OpenAI sin versión suele significar que necesita/v1. El mensaje sugiere la URL corregida. - La URL debe usar
https://y resolverse a una dirección pública. Una URL que se resuelve a una dirección privada o reservada se rechaza.
Test rechaza la temperatura o el razonamiento que definí
Test rechaza la temperatura o el razonamiento que definí
- Algunos modelos fijan la temperatura o siempre razonan (Kimi
k2p7-code/k3, GLM-5.3; Claude 4.7+/GPT-5 eliminan la temperatura por completo). Test valida tu ajuste contra las reglas del modelo y devuelve un mensaje específico: síguelo (deja la temperatura sin definir o usa el valor requerido; no pongas el razonamiento en Off en un modelo que siempre razona). Consulta Temperatura.
'Rate limited' o 'Too much concurrency'
'Rate limited' o 'Too much concurrency'
- Reduce Max concurrent requests en Advanced settings.
- Si Z.AI autoriza el uso del GLM Coding Plan, confirma con Z.AI el límite de tu plan. Consulta Ajustar la concurrencia.
- En el Kimi Code Plan, reduce el tope si el error indica que alcanzaste el límite de solicitudes concurrentes. Consulta Ajustar la concurrencia.
Las variables de entorno del alojamiento autónomo no aparecen
Las variables de entorno del alojamiento autónomo no aparecen
- Si Kodus está configurada mediante variables de entorno, la página AI providers muestra Kodus is currently using an LLM configured via environment variables con el modelo y el proveedor (y si el proveedor se definió en
API_LLM_PROVIDERo se dedujo), mientras no haya un modelo conectado allí. La clave nunca se muestra. - Conectar un modelo y guardar reemplaza la configuración del entorno.
Costos altos o inesperados
Costos altos o inesperados
- El razonamiento agrega tokens. Si el costo se dispara, baja Thinking / Reasoning de Medium a Low, o enruta las tareas más ligeras a un modelo más barato en Other task models de Code review → Routing.
- Consulta Uso de tokens para ver lo que cuesta cada modelo, PR, revisión y desarrollador, revisa el panel de tu proveedor para el desglose por modelo, y define un presupuesto mensual con alertas de gasto en la pestaña Budget (solo alertas; define un tope duro con tu proveedor).
Preguntas frecuentes
¿Puedo cambiar de proveedor en cualquier momento?
¿Puedo cambiar de proveedor en cualquier momento?
¿Qué pasa si mi clave de API se queda sin créditos?
¿Qué pasa si mi clave de API se queda sin créditos?
¿Cómo funciona el sistema de modelo por defecto / respaldo?
¿Cómo funciona el sistema de modelo por defecto / respaldo?
¿Pueden distintas tareas usar distintos modelos?
¿Pueden distintas tareas usar distintos modelos?
¿Almacenan nuestras claves de API de forma segura?
¿Almacenan nuestras claves de API de forma segura?
¿Puedo usar un LLM de alojamiento autónomo (p. ej., Ollama, vLLM)?
¿Puedo usar un LLM de alojamiento autónomo (p. ej., Ollama, vLLM)?
https:// que se resuelva a una dirección pública, por lo que localhost y las direcciones de red privada se rechazan. En una instancia autoalojada de Kodus, define un endpoint en una red privada con variables de entorno en su lugar; consulta Instalación.