Saltar al contenido principal
Elige tu proveedor para ver cómo obtener una clave y qué ingresar. Agrega el modelo en la página AI providers; consulta Conectar un proveedor.

Proveedores compatibles

Ideal para: los últimos modelos GPT y un rendimiento confiable.Obtener una clave de API:
  1. Visita OpenAI API Keys
  2. Crea una clave nueva para Kodus
  3. Agrega la información de facturación
A través de tu propio gateway: si tu tráfico de OpenAI pasa por un gateway con protocolo OpenAI que sirve la Responses API, define su dirección en el campo opcional Base URL y usa la clave que el gateway espera. Con los IDs de modelo propios de OpenAI, las revisiones se ejecutan entonces como con una clave directa de OpenAI: la Responses API, salida estructurada estricta y tu nivel de razonamiento.
  • Incluye la versión de la API, como en https://your-gateway.example.com/v1. Kodus llama a <Base URL>/responses y 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.
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 solo thinking.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.
Para una configuración estable, fija un solo proveedor y desactiva los respaldos (Pin: moonshot, Allow fallbacks: off). Las solicitudes siempre llegarán al mismo upstream o fallarán de forma explícita, sin cambios silenciosos de calidad. La contrapartida es cero resiliencia si ese único upstream se cae; combínalo con un Fallback model en otro proveedor (p. ej., Anthropic) para absorber las caídas.
Los nombres de upstream deben coincidir con el catálogo de OpenRouter. Revisa las etiquetas de proveedor en openrouter.ai/docs/features/provider-routing; los valores comunes incluyen moonshot, together, groq, fireworks, novita.
Por debajo, Kodus emite esto en la llamada al Vercel AI SDK:

Avanzado: anulación con JSON sin procesar

Si necesitas campos más allá de order 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: