跳转到主要内容
请选择您的提供商,了解如何获取密钥以及需要输入什么。在 AI providers 页面添加模型;参见连接提供商。

受支持的提供商

最适合: 最新的 GPT 模型和可靠的性能。获取 API 密钥:
  1. 访问 OpenAI API Keys
  2. 为 Kodus 创建新密钥
  3. 添加账单信息
通过您自己的网关: 如果您的 OpenAI 流量经过提供 Responses API 的 OpenAI 协议网关,请在可选的 Base URL 中设置其地址,并使用网关所需的密钥。使用 OpenAI 自己的模型 ID 时,审查的运行方式与直接使用 OpenAI 密钥相同:Responses API、严格的结构化输出,以及您的推理级别。
  • 包含 API 版本,例如 https://your-gateway.example.com/v1。Kodus 会调用 <Base URL>/responses,并从 <Base URL>/models 列出模型。
  • 如果网关只提供 chat completions,请改为以 OpenAI-compatible 连接它。
  • URL 必须使用 https:// 并解析到公网地址,因为 Kodus 会把您的密钥发送到那里。不支持位于自托管安装私有网络中的网关。
  • 请求以 store: false 发出,因此不会要求网关或 OpenAI 保留它们。
  • 使用 OpenAI 自己的模型 ID(例如 gpt-5.4)。被网关重命名的模型不会被识别为推理模型,因此不会发送其推理级别。
  • 此处不支持:除密钥外还需要自有请求头的网关(Portkey、Cloudflare AI Gateway),以及 Azure OpenAI,后者有自己的 Azure OpenAI 提供商。

连接 Kimi(Moonshot)和 GLM(Z.ai)

Moonshot 和 Z.ai 各自提供一个订阅套餐,其端点与各自按 token 付费的开发者 API 不同。每个套餐是独立的账号,有各自的密钥 — 请选择与您持有的密钥匹配的 base URL。 Moonshot 磁贴使用开发者 API 的 Anthropic 兼容端点(https://api.moonshot.ai/anthropic)。Z.ai 磁贴使用 Z.AI 为 GLM Coding Plan 提供的 https://api.z.ai/api/anthropic。使用 Z.AI Developer API 时,请在 Custom 中选择 OpenAI-compatible 并输入 https://api.z.ai/api/paas/v4/。使用 Kimi Code Plan 密钥时,请在 Custom 中选择兼容的提供商并输入表中的基础 URL。
使用 Kimi Code Plan 时,请从较低的上限开始,根据账号情况调整。请参阅 调整并发。Kimi K2.7 Code 始终开启推理。Kodus 会隐藏温度字段,并在请求中省略该参数。参见温度。

固定 OpenRouter 提供商

OpenRouter 是一个路由器 — 当您请求某个模型(例如 moonshotai/kimi-k2)时,它会把调用转发给多个上游提供商之一(Moonshot 直连、Together、Groq、Fireworks、Novita……)。每次调用可能落到不同的后端。这很方便,但会带来无声的差异:
  • 质量漂移 — 上游以不同的精度运行(FP8、INT4、完整精度),对相同的提示给出略有差异的输出
  • 工具调用不一致 — 有些后端对函数调用的支持方式不同,导致工具使用格式错误
  • 推理格式差异 — 一个上游遵从 reasoning_effort,另一个只认 thinking.enabled,还有一个两者都忽略
  • 延迟波动 — 随着路由变化,p50 可能在调用之间从 800ms 跳到 4s
  • 速率限制意外 — 您在一个并非自己明确选择的后端上触及了配额

如何固定

当您的 BYOK 提供商是 OpenRouter 时,Advanced settings 面板会显示一个 OpenRouter routing 部分,包含两个字段:
  • Pin providers (in order) — 以逗号分隔的上游名称列表(例如 moonshot, together)。OpenRouter 按顺序尝试它们,并使用第一个可用的。
  • Allow fallbacks — 关闭时,如果所有固定的提供商都不可用,请求会直接失败。开启时(默认),OpenRouter 可以回退到任何其他提供该模型的上游。
要获得稳定的配置,请固定单个提供商并关闭回退(Pin: moonshot、Allow fallbacks: off)。请求将始终命中同一个上游,否则明确失败 — 不会有无声的质量变化。代价是如果该上游宕机则毫无韧性;请搭配另一个提供商(例如 Anthropic)上的 Fallback model 来吸收故障。
上游名称必须与 OpenRouter 的目录一致。请查看 openrouter.ai/docs/features/provider-routing 上的提供商标签 — 常见值包括 moonshot、together、groq、fireworks、novita。
在底层,Kodus 会把下面的内容传入 Vercel AI SDK 调用:

高级:原始 JSON 覆盖

如果您需要 order 和 allow_fallbacks 之外的字段(例如 ignore、data_collection、require_parameters),请在 Advanced settings 中将 Thinking / Reasoning 切换为 Custom(自定义 JSON 覆盖),并粘贴完整的路由负载 — 它会与任何推理配置一起合并到 providerOptions 中: