受支持的提供商
- OpenAI
- Google Gemini
- Anthropic Claude
- Novita AI
- OpenRouter
- Google Vertex AI
- Amazon Bedrock
- Azure OpenAI
- OpenAI-compatible
- Anthropic-compatible
最适合: 最新的 GPT 模型和可靠的性能。获取 API 密钥:
- 访问 OpenAI API Keys
- 为 Kodus 创建新密钥
- 添加账单信息
- 包含 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 (Moonshot AI)
- GLM (Z.ai)
固定 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 可以回退到任何其他提供该模型的上游。
高级:原始 JSON 覆盖
如果您需要order 和 allow_fallbacks 之外的字段(例如 ignore、data_collection、require_parameters),请在 Advanced settings 中将 Thinking / Reasoning 切换为 Custom(自定义 JSON 覆盖),并粘贴完整的路由负载 — 它会与任何推理配置一起合并到 providerOptions 中: