Skip to content
FunCoding

Search

Search docs, Skills and MCP

模型网关与路由

连接统一网关,区分凭据、底层提供商路由和模型选项。

This page has not been translated into English yet. The original Chinese version is shown below.

模型网关为多个后端提供统一接入,但账户、路由和数据策略仍由具体服务决定。OpenCode 的网关配置不是对底层所有提供商的统一权限保证。

Cloudflare 两种入口

入口需要的信息环境变量方式
Cloudflare AI GatewayAccount ID、Gateway ID、API tokenCLOUDFLARE_ACCOUNT_ID、CLOUDFLARE_GATEWAY_ID、CLOUDFLARE_API_TOKEN
Cloudflare Workers AIAccount ID、API tokenCLOUDFLARE_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。它们的模型、路由与服务条件仍需按该网关目录核对,不应以一个服务的配置字段推断另一个服务支持相同功能。