NNexithDocs
状态控制台 ↗
概览与快速开始模型目录指南API 参考集成OAuth2 / OIDC

在 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 两种头网关都接受。