Yuan API

OpenCode 配置教程 ​

外接兼容说明

第三方客户端与服务端之间可能存在兼容性差异。本教程演示基础接入方式，不能保证每个模型、智能体或工具都完全兼容。遇到个别功能异常时，可以先更换模型并用最小请求验证。

一、打开配置目录 ​

OpenCode 的配置目录为 .config/opencode，位于用户主目录下，配置文件是 opencode.json：

text
%userprofile%\.config\opencode
bash
open ~/.config/opencode
bash
cd ~/.config/opencode

如果目录中没有 opencode.json，请手动创建。

二、编辑 opencode.json ​

将下面配置写入 opencode.json，把 your-model-id 和 API Key 替换为你的实际配置：

json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "yuan-api": {
      "npm": "@ai-sdk/openai",
      "options": {
        "apiKey": "你的 API Key",
        "baseURL": "https://api.apixhm.com/v1",
        "setCacheKey": true
      },
      "models": {
        "your-model-id": {
          "name": "your-model-id",
          "options": {
            "reasoningEffort": "high"
          }
        }
      }
    }
  }
}

字段说明：

  • yuan-api：供应商标识，只能使用小写字母、数字和连字符。
  • baseURL：使用 https://api.apixhm.com/v1。
  • apiKey：填写你的 Yuan API Key。
  • models：键和值都应使用 模型与价格页面中的实际模型 ID。
  • reasoningEffort：如果当前模型和客户端支持，可使用 low、medium、high 等值。
  • setCacheKey：缓存设置，通常保持 true。

保存后重新打开终端，运行：

bash
opencode

然后在模型选择器中选择 yuan-api/your-model-id。

提示

如果配置后无法启动，请先删除可选参数，只保留 apiKey、baseURL 和模型名称，再查看外接与兼容类问题。

Copyright © 2026 Yuan API