Proveedores compatibles
- OpenAI
- Google Gemini
- Anthropic Claude
- Novita AI
- OpenRouter
- Google Vertex AI
- Amazon Bedrock
- Azure OpenAI
- OpenAI-compatible
- Anthropic-compatible
Ideal para: los últimos modelos GPT y un rendimiento confiable.Obtener una clave de API:
- Visita OpenAI API Keys
- Crea una clave nueva para Kodus
- Agrega la información de facturación
- Incluye la versión de la API, como en
https://your-gateway.example.com/v1. Kodus llama a<Base URL>/responsesy lista los modelos desde<Base URL>/models. - Si el gateway solo sirve chat completions, conéctalo como OpenAI-compatible en su lugar.
- La URL debe usar
https://y resolverse a una dirección pública, porque Kodus envía tu clave allí. Los gateways en la red privada de una instalación con alojamiento autónomo no son compatibles. - Las solicitudes salen con
store: false, así que no se le pide ni al gateway ni a OpenAI que las conserve. - Usa los IDs de modelo propios de OpenAI (por ejemplo
gpt-5.4). Un modelo que el gateway renombra no se reconoce como modelo de razonamiento, por lo que su nivel de razonamiento no se envía. - No compatibles aquí: los gateways que necesitan sus propios encabezados además de la clave (Portkey, Cloudflare AI Gateway), y Azure OpenAI, que tiene su propio proveedor Azure OpenAI.
Conectar Kimi (Moonshot) y GLM (Z.ai)
Moonshot y Z.ai ofrecen cada uno un plan de suscripción en un endpoint distinto al de su Developer API de pago por token. Cada plan es una cuenta separada con su propia clave: elige la URL base que coincida con la clave que tienes. El mosaico Moonshot usa el endpoint de la Developer API compatible con Anthropic (https://api.moonshot.ai/anthropic). El mosaico Z.ai usa https://api.z.ai/api/anthropic, el endpoint que Z.AI documenta para el GLM Coding Plan. Para usar la Developer API de Z.AI, selecciona OpenAI-compatible en Custom y usa https://api.z.ai/api/paas/v4/. Para una clave de Kimi Code Plan, elige un proveedor compatible en Custom e introduce la URL base de la tabla.
- Kimi (Moonshot AI)
- GLM (Z.ai)
En el Kimi Code Plan, empieza con un límite bajo y ajústalo según tu cuenta. Consulta Ajustar la concurrencia. Kimi K2.7 Code siempre razona. Kodus oculta el campo de temperatura y omite el parámetro en las solicitudes. Consulta Temperatura.
Fijar proveedores de OpenRouter
OpenRouter es un enrutador: cuando solicitas un modelo (p. ej.,moonshotai/kimi-k2), reenvía la llamada a uno de varios proveedores upstream (Moonshot directo, Together, Groq, Fireworks, Novita…). Cada llamada puede terminar en un backend distinto. Es conveniente, pero introduce varianza silenciosa:
- Deriva de calidad — los upstreams ejecutan precisiones distintas (FP8, INT4, completa) y dan salidas sutilmente diferentes para prompts idénticos
- Inconsistencia en las llamadas a herramientas — algunos backends no admiten function calling de la misma forma, lo que lleva a un uso de herramientas mal formado
- Varianza en el formato de razonamiento — un upstream respeta
reasoning_effort, otro solothinking.enabled, otro ignora ambos - Oscilaciones de latencia — la p50 puede saltar de 800 ms a 4 s entre llamadas a medida que cambia el enrutamiento
- Sorpresas de límite de velocidad — alcanzas la cuota en un backend que no elegiste explícitamente
Cómo fijar
Cuando tu proveedor BYOK es OpenRouter, el panel de Advanced settings muestra una sección OpenRouter routing con dos campos:- Pin providers (in order) — lista separada por comas de nombres de upstream (p. ej.,
moonshot, together). OpenRouter los prueba en orden y usa el primero disponible. - Allow fallbacks — cuando está desactivado, las solicitudes fallan de forma definitiva si ninguno de los proveedores fijados está disponible. Cuando está activado (por defecto), OpenRouter puede recurrir a cualquier otro upstream que sirva el modelo.
Avanzado: anulación con JSON sin procesar
Si necesitas campos más allá deorder y allow_fallbacks (p. ej., ignore, data_collection, require_parameters), cambia Thinking / Reasoning a Custom en Advanced settings (Anulación con JSON personalizado) y pega la carga completa de enrutamiento: se fusiona en providerOptions junto con cualquier configuración de razonamiento: