在 opencode 中使用 Nexith
opencode 走标准 OpenAI 兼容协议(POST /v1/chat/completions),这是最通用的一条路径,
也是大多数第三方工具接入的方式。
配置#
opencode 通过 provider 配置声明一个 OpenAI 兼容后端:
{
"provider": {
"nexith": {
"npm": "@ai-sdk/openai-compatible",
"name": "Nexith",
"options": {
"baseURL": "https://gateway.nexith.ai/v1",
"apiKey": "nx-你的key"
},
"models": {
"nexith-core": { "name": "Nexith Core" }
}
}
}
}配置键名以 opencode 自身文档为准;Nexith 侧需要的就是 baseURL 带
/v1+ apiKey 用nx-key。https://api.nexith.ai/v1同样可用。
Nexith 侧支持情况#
| 能力 | 状态 |
|---|---|
POST /v1/chat/completions(流式/非流式) |
✅ |
tools / tool_choice / parallel_tool_calls |
✅ 原样透传 |
tool_calls 流式分片(index + function.arguments 增量) |
✅ 原样转发,不重排 |
finish_reason: "tool_calls" |
✅ 原样保留 |
assistant 消息回放(tool_calls + tool_call_id) |
✅ |
GET /v1/models |
✅ |
| Anthropic / Responses 协议 | 见 claude-code.md / codex.md |
tools 非空时,网关会把上游的 reasoning_effort 规整为 none(带工具时推理会拖慢并吃光
token 预算),这是有意为之。
计费与长任务#
- 单请求 120 秒上限(当前)。opencode 的长 agent 循环若单轮超过 120s 会被截断——正在处理中。
- 流式响应当前不带
stream_options.include_usage,所以上游不会回流式用量: 计费基于估算,且 prompt cache 折扣不会生效。这对重复前缀很多的 agent 循环影响较大, 已列入待办。 - 超过 32k 上下文的
nexith-core请求自动升级到更强上游并按升级档位计价。
故障排除#
流式响应卡住 / 长时间无输出 上游长思考期间网关不发任何字节(当前没有 SSE 心跳)。已列入待办。
工具名或参数丢失
上游若非规范地先发 arguments 再发 name,当前实现会把名字固化为空。标准上游无此问题。
401
key 需为 nx- 开头。注意 Authorization: Bearer 与 x-api-key 两种头网关都接受。