集成OpenCode

OpenCode

OpenCode 支持把任何兼容 OpenAI 的 API 添加为自定义服务商,通过 @ai-sdk/openai-compatible 包连接 https://api.abliteratedllm.dev/v1。以下配置适用于 OpenCode 1.x 和 2.x。

占位符:$API_BASE 为 https://api.abliteratedllm.dev/v1,$API_ORIGIN 为 https://api.abliteratedllm.dev,$YOUR_KEY 为你的 API 密钥。

已登录?API 密钥页面为我们当前提供的每个模型准备好了这个文件,附带实时价格、高亮显示的服务商配置块和下载按钮。

1. 在 opencode.json 中添加服务商

全局配置文件在 macOS 和 Linux 上为 ~/.config/opencode/opencode.json,在 Windows 上为 %USERPROFILE%\.config\opencode\opencode.json。如果只用于单个项目,改用项目根目录下的 opencode.json。

json
{
  "$schema": "https://opencode.ai/config.json",
  "model": "abliteratedllm/glm-5.3-flash-abliterated",
  "provider": {
    "abliteratedllm": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AbliteratedLLM",
      "options": {
        "baseURL": "$API_BASE",
        "apiKey": "{env:ABLITERATEDLLM_API_KEY}"
      },
      "models": {
        "glm-5.3-flash-abliterated": {
          "name": "GLM-5.3 Flash Abliterated",
          "reasoning": true,
          "tool_call": true,
          "attachment": true,
          "modalities": {
            "input": [
              "text",
              "image"
            ],
            "output": [
              "text"
            ]
          },
          "limit": {
            "context": 1048576,
            "output": 131072
          },
          "cost": {
            "input": 0.0977,
            "output": 0.3421,
            "cache_read": 0.0098,
            "cache_write": 0
          }
        }
      }
    }
  }
}
  • 新文件:按原样保存。已有文件:只把 "abliteratedllm" 条目复制到你的 "provider" 对象中,用逗号与它前面的服务商隔开,并保留你的其他服务商。只有想把它设为默认模型时,才设置 "model"。
  • npm 为 @ai-sdk/openai-compatible,它调用 /v1/chat/completions。
  • models 下的键必须与我们的模型 ID 完全一致。GET /v1/models 中的每个 ID 各添加一个条目;控制台中的文件已经全部列出。
  • limit.context 和 limit.output 是 GET /v1/models 中该模型的 context_length 和 max_output_tokens,这样 OpenCode 就知道还剩多少上下文。在试用账户上,无论如何设置,输出上限都是 4096 个 token。
  • cost 以每百万 token 的美元价格表示(输入、输出和缓存输入),这样 OpenCode 显示的费用与我们的计费一致。缓存写入不收费。
  • reasoning 标记会先推理再回答的模型。attachment 和 modalities 告诉 OpenCode 模型接受哪些输入。此模型接受文本和图像;对于支持视频的模型,控制台中的文件还会列出 video。如果你之前已经配置过此模型,刷新或下载它的配置并合并更新后的条目,这样 OpenCode 才会允许附件。
  • 不要写 V1 的 api 字段。OpenCode 2 迁移设置了该字段的配置时,会用它的值替换 baseURL(issue #50286)。

2. 配置密钥

文件通过 {env:ABLITERATEDLLM_API_KEY} 从 ABLITERATEDLLM_API_KEY 环境变量读取你的密钥,因此密钥永远不会写进文件。

Bash 或 Zsh(把这一行加到 ~/.zshrc 或 ~/.bashrc 中即可长期保留):

bash
export ABLITERATEDLLM_API_KEY="$YOUR_KEY"

Windows(对之后打开的终端生效):

powershell
setx ABLITERATEDLLM_API_KEY "$YOUR_KEY"

如果想改用 /connect 保存密钥,先从文件中删除 "apiKey" 这一行,以及它上面 "baseURL" 行末尾的逗号。然后启动 opencode,运行 /connect,选择 Other,输入服务商 ID abliteratedllm,再粘贴 $YOUR_KEY。OpenCode 1.x 会把它保存在 ~/.local/share/opencode/auth.json 中。

两种方法只用一种,不要同时使用。OpenCode 1.x 会优先使用文件中设置的密钥,而不是用 /connect 保存的密钥;而未设置的 {env:…} 变量会变成空密钥,因此保存的密钥会被忽略。轮换密钥时,更新环境变量或重新运行 /connect。

3. 选择模型,打个招呼

bash
opencode --model abliteratedllm/glm-5.3-flash-abliterated

文件中的 "model" 已经把它设为默认模型,所以直接运行 opencode 也可以。运行 /models 可以切换到我们的其他模型。

注意事项

  • 图像:图像附件仅适用于 GET /v1/models 中 input_modalities 包含 image 的模型。使用其他模型时,请求会以 400 unsupported_content 失败。
  • 试用账户只允许 1 个并发请求,对智能体工作来说比较紧张。参见速率限制与试用。

已于 2026 年 11 月 3 日对照 OpenCode 文档核实:Providers, custom provider、Config, variables 和 Models。