模型网关与路由
连接统一网关,区分凭据、底层提供商路由和模型选项。
This page has not been translated into English yet. The original Chinese version is shown below.
模型网关为多个后端提供统一接入,但账户、路由和数据策略仍由具体服务决定。OpenCode 的网关配置不是对底层所有提供商的统一权限保证。
Cloudflare 两种入口
| 入口 | 需要的信息 | 环境变量方式 |
|---|---|---|
| Cloudflare AI Gateway | Account ID、Gateway ID、API token | CLOUDFLARE_ACCOUNT_ID、CLOUDFLARE_GATEWAY_ID、CLOUDFLARE_API_TOKEN |
| Cloudflare Workers AI | Account ID、API token | CLOUDFLARE_ACCOUNT_ID、CLOUDFLARE_API_KEY |
也可在 /connect 选择对应入口并按顺序输入。Gateway 的模型可在 provider.cloudflare-ai-gateway.models 补充;启用 Unified Billing 时可避免逐个提供底层服务 Key,不能将此条件省略为所有网关配置都无需额外凭据。
Workers AI 直接使用其支持的模型,与 AI Gateway 的路由范围不同;尤其注意环境变量 TOKEN 与 KEY 的名称差异。
OpenRouter 与 Vercel
OpenRouter 通过 /connect 保存 Key,可在 provider.openrouter.models 添加模型。模型 options.provider.order 指定底层提供商顺序,allow_fallbacks: false 可关闭该示例中的回退。
Vercel AI Gateway 同样通过专门入口连接。其模型 options 支持 order、only 和 zeroDataRetention:分别控制尝试顺序、限定提供商及只使用具有相应零保留政策的提供商。字段层级与 OpenRouter 不同,不能原样搬移整个 options 对象。
Helicone
Helicone 网关提供日志、监控和分析。连接后可以补充模型,并在 options.headers 设置特定 header:
| Header | 用途 |
|---|---|
Helicone-Cache-Enabled | 控制响应缓存 |
Helicone-User-Id | 用户维度指标 |
Helicone-Property-[Name] | 自定义属性 |
Helicone-Prompt-Id | 关联提示版本 |
官方还介绍 opencode-helicone-session 插件,为请求添加 Helicone-Session-Id 和 Helicone-Session-Name,按 OpenCode 会话分组。选择日志与会话跟踪配置前应确认组织的数据处理要求;插件并不是连接网关的必需步骤。
Eden AI 与其他网关
Eden AI 默认 endpoint 为 https://api.edenai.run/v3,可通过 provider.edenai.options.baseURL 改为 https://api.eu.edenai.run/v3。EU 目录是可用模型子集,更换端点后原先的模型未必可达。
Eden AI 模型 ID 自身可以包含 vendor/model,因此完整 OpenCode ID 可以有三段,不能按只有一个斜杠来拆分所有模型。
LLM Gateway 与 ZenMux 都可从连接菜单添加 Key,并在各自 provider 下补充 models。它们的模型、路由与服务条件仍需按该网关目录核对,不应以一个服务的配置字段推断另一个服务支持相同功能。