OpenCode

OpenCode 通过 @ai-sdk/openai-compatible package 与 UberLLM 通信。您只需存储一次 key，然后通过 opencode.json 描述 provider。

开始之前

一个有余额的 UberLLM 账户，以及一个来自 Dashboard → 密钥 (ull_...) 的 API key。

1. 保存密钥

在 OpenCode 中，运行 /connect，滚动到 Other，输入 provider id uberllm，然后粘贴您的密钥。OpenCode 会将其保存在 ~/.local/share/opencode/auth.json 中。您在此处输入的 id 必须与 opencode.json 中的 provider id 匹配。

2. 添加提供商

全局文件：~/.config/opencode/opencode.json。项目文件：opencode.json 在项目根目录中（它会覆盖全局文件）。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "uberllm": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "UberLLM",
      "options": {
        "baseURL": "https://api.uberllm.dev/v1"
      },
      "models": {
        "deepseek/deepseek-v4.1-flash": { "name": "DeepSeek V4.1 Flash", "limit": { "context": 1048576, "output": 384000 } },
        "z-ai/glm-5.2": { "name": "GLM 5.2", "limit": { "context": 1048576, "output": 32768 } },
        "moonshotai/kimi-k3": { "name": "Kimi K3", "limit": { "context": 1048576, "output": 32768 } }
      }
    }
  }
}

要跳过 /connect，请将密钥放入文件中，而不是："apiKey": "{env:UBERLLM_API_KEY}" 在 options 内部。

OpenCode 仅列出您在此处命名的模型。目录中的任何 ID 目录都有效。

3. 选择模型

运行 /models 并选择一个 UberLLM 模型。

常见错误

您看到什么	原因和解决方案
`401`	缺少此提供商的密钥。运行 `opencode auth list`；ID 在两处都必须是 `uberllm`。
`404` 显示 "page not found"	`baseURL` 必须是 `https://api.uberllm.dev/v1`。请使用 `@ai-sdk/openai-compatible`，此设置已通过该提供商进行测试。
`404` `model_not_found`	`models` 中的模型密钥不是目录 ID。
`402` `insufficient_credits`	余额不足。请在 Dashboard → Credits 中充值。

模型 ID	上下文	最大输出
`deepseek/deepseek-v4.1-flash`	1,048,576	384,000
`z-ai/glm-5.2`	1,048,576	32,768
`moonshotai/kimi-k3`	1,048,576	32,768