U9 AI · DOCUMENTATION

OpenCode 接入指南

OpenCode 配置入口、地址填写、模型选择、验收步骤和 MD 下载。

适用范围与前提#

本页提供 OpenCode 对接本站的配置说明。需要启用的本站密钥、可用余额以及协议匹配的实际可用模型。2026-10-24 已核对官方资料；这不代表每个客户端版本及上游模型都已完成全流程测试。

配置步骤#

1. 将下面 provider 条目合并到已有 opencode.json，不覆盖其他供应商配置。
2. 使用 @ai-sdk/openai-compatible 连接 Chat Completions；如要调用 Responses，需要改用对应适配器并另行验证。
3. 在启动终端设置 U9AI_API_KEY，替换两处模型 ID 占位符；配置只引用环境变量，不保存真实密钥。
4. 启动后选择 u9ai 下的模型，在临时项目验证短对话、流式输出和工具调用。

配置值对照#

{
  "$schema": "https://opencode.ai/config.json",
  "model": "u9ai/YOUR_CHAT_MODEL_ID",
  "provider": {
    "u9ai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "U9 AI",
      "options": {
        "baseURL": "https://u9ai.ai/v1",
        "apiKey": "{env:U9AI_API_KEY}"
      },
      "models": {
        "YOUR_CHAT_MODEL_ID": {
          "name": "U9 Chat"
        }
      }
    }
  }
}

这个工具需要特别注意#

这是 Chat Completions 模板，不把模型名中含 codex 当作协议依据。若模型需要上下文和输出限制，按真实规格补充，不能复制其他模型的数值。

验收与交接#

先按快速开始执行只读 GET /v1/models，确认认证和目录。再分别验收短文本非流式请求、流式输出及所需的完整工具调用往返。生成测试可能扣费，请保留请求号并核对消费分析。失败时在工单提供客户端版本、模型 ID、端点、状态码和脱敏错误；超时任务不要盲目重提。

可将本 MD 直接交给开发者或 Agent 阅读，要求保留原配置、只替换实际可用模型，并明确报告未验证项。真实密钥不要写入共享 MD。

官方参考#

OpenCode