OpenCode

模型调用暂未开放

本页内容用于接入准备。调用开放后，请使用你自己的可用 Key，并把示例中的模型占位值换成模型广场中实际开放的型号。

需要哪种接口

普通对话（OpenAI Chat Completions）。在模型广场的「端点类型」里选择 Chat。

开始之前

完成实名认证，认证通过后重新登录一次。
在主站「API 密钥」页面创建一把 Key，复制并妥善保存。
在模型广场的「端点类型」筛选里选择 Chat（窄屏时点“筛选”按钮），从列出的模型中复制模型 ID。

另外需要先安装好 OpenCode，安装方法见 OpenCode 官方文档。

配置步骤

添加服务商

在项目目录的 opencode.json 中加入下面第一个标签里的 provider 部分；文件不存在就新建。全局配置文件的位置见 OpenCode 官方说明。

设置 Key

示例里的 {env:AIPUT_API_KEY} 表示从环境变量读取 Key，见第二、三个标签。也可以不写 apiKey 这一项，改为在 OpenCode 中运行 /connect，选择 Other，服务商 ID 填 aiput，再粘贴 Key。

选择模型

在 OpenCode 中运行 /models，选择 AIPUT 下的模型。

opencode.json · 配置示例

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aiput": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AIPUT",
      "options": {
        "baseURL": "https://api.aiput.top/v1",
        "apiKey": "{env:AIPUT_API_KEY}"
      },
      "models": {
        "MODEL_ID_FROM_CATALOG": {
          "name": "MODEL_ID_FROM_CATALOG"
        }
      }
    }
  }
}

终端 · 设置 Key

export AIPUT_API_KEY='YOUR_API_KEY'

PowerShell · 设置 Key

$env:AIPUT_API_KEY = "YOUR_API_KEY"

各项的含义：

npm：@ai-sdk/openai-compatible 表示按普通对话格式发送请求。
options.baseURL：AIPUT 的地址，带 /v1。
models：可用的模型，键名填模型广场里的模型 ID；想加多个模型，就照样多写几项。

怎样确认配置成功

选择 AIPUT 的模型后，发一句简短的问题，能收到回复就说明配置成功。

OpenCode 自身的限制

OpenCode 作为编程助手，会让模型读写文件、执行命令，对模型的工具调用能力要求较高，不同模型效果差别较大。建议先用小任务试用。

常见问题

现象	处理
`/models` 里看不到 AIPUT	检查 `opencode.json` 是否在当前项目目录，JSON 格式是否正确
`401`	环境变量没有设置，或 `/connect` 时填的服务商 ID 不是 `aiput`
`404`	`baseURL` 只写到 `/v1`，不要多写路径
提示无法解析返回内容	`baseURL` 少写了 `/v1`
"无可用渠道"	账户还没有实名认证、模型 ID 写错，或模型当前不可用，见常见问题

本页按 2026 年 10 月的 OpenCode 版本编写，界面和配置项可能随版本变化，以 OpenCode 官方说明为准。OpenCode 的名称和商标归其所有者所有，这里只表示兼容。

本页目录