跳到正文
FunCoding

搜索

搜索文档、Skill 和 MCP

模型网关与路由

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

模型网关为多个后端提供统一接入,但账户、路由和数据策略仍由具体服务决定。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。它们的模型、路由与服务条件仍需按该网关目录核对,不应以一个服务的配置字段推断另一个服务支持相同功能。