provider 配置管理模型。接入 powertokens 平台 时,推荐先使用 OpenAI-compatible custom provider,把 opencode 指向平台的 /v1/chat/completions 兼容接口。
本文面向 opencode 文本代理场景。/v1/models 中部分图片、语音、视频任务模型也会声明 openai,但它们不等于 opencode 可直接使用的文本 Chat Completions 模型。
如果你需要先判断模型应走哪个端点,请先看 文本模型协议与端点支持说明。
路径选择
| 目标 | opencode provider | Base URL | 推荐模型 |
|---|---|---|---|
| 推荐文本路径 | custom provider + @ai-sdk/openai-compatible | https://api.powertokens.ai/v1 | glm-5.2 |
| MiniMax 文本路径 | custom provider + @ai-sdk/openai-compatible | https://api.powertokens.ai/v1 | MiniMax-M3 |
| Claude/Anthropic 路径 | @ai-sdk/anthropic custom provider | https://api.powertokens.ai/v1 | 仅在你需要复核 /v1/messages 时使用 |
准备 API Key
把powertokens 平台 API Key 放到环境变量中,避免写入仓库:
/connect,按 provider 保存凭据。配置文件里的 provider ID 需要和 /connect 保存的 provider ID 一致。
OpenAI-compatible provider 示例
在项目中创建或更新.opencode/opencode.json:
POST /v1/chat/completions。
模型选择
OpenAI-compatible 路径默认使用glm-5.2;MiniMax 场景使用 MiniMax-M3。需要 BytePlus 或 Seed 文本模型时,也优先放在 OpenAI-compatible provider 中。
不要把 image-generation、openai-video、TTS、Kling、Vidu 或 Wan 任务模型加入 opencode 文本 provider。完整文本模型矩阵见 文本模型协议与端点支持说明。
Anthropic provider 示例
如果你要让 opencode 走 Claude/Anthropic Messages 路径,可以单独配置一个@ai-sdk/anthropic custom provider。该路径会走平台的 /v1/messages,请单独复核当前 opencode 版本与目标模型的端到端行为。
glm-5.2;MiniMax 场景推荐使用 MiniMax-M3。deepseek-v3-2-251201 已通过 opencode Anthropic provider 工具链复测;Seed 系列中除 seed-1-6-flash-250715 外,也已通过复测,可按真实任务选择。不要把 seed-1-6-flash-250715 作为 opencode Anthropic provider 的默认模型。
验证
先确认 opencode 能读到 provider 和模型:powertokens/glm-5.2 或 powertokens-anthropic/glm-5.2 后发送一个小任务:
能力边界
- opencode 的
@ai-sdk/openai-compatibleprovider 只覆盖文本 Chat Completions 语义。 supported_endpoint_types里带openai不代表该模型适合 opencode 文本代理;请排除图片、语音、视频和任务型模型。MiniMax-M3等 reasoning 模型可能返回思考内容或消耗额外输出 token,请用真实任务确认展示效果。supported_endpoint_types里带anthropic不代表该模型适合 opencode Anthropic provider;opencode 会携带工具参数并使用流式输出,需要按端到端行为筛选模型。deepseek-v3-2-251201已通过 opencode Anthropic provider 带工具任务复测。seed-1-6-flash-250715上游不支持/v1/messages;请优先走 OpenAI-compatible provider。- 不要把真实 API Key 写入
.opencode/opencode.json或提交到仓库。