在 OpenCode 中使用 Muapi

在 OpenCode 中添加 Muapi 作为 OpenAI 兼容的自定义提供商，即可使用 Muapi 文本模型。

1. 创建密钥并选择模型

在 Muapi 控制台创建 API 密钥，然后列出可用的文本模型：

curl -s "https://api.muapi.ai/v1/models?type=text" \
  -H "Authorization: Bearer $MUAPI_API_KEY"

选择响应中 capabilities.tools: true 的模型。OpenCode 需要工具支持才能编辑文件和执行终端操作。

2. 添加 Muapi 提供商

在启动 OpenCode 的 shell 中设置 MUAPI_API_KEY。macOS 或 Linux：

export MUAPI_API_KEY="your-muapi-api-key"

将以下提供商添加到项目级或全局 opencode.json 配置文件：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "muapi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Muapi",
      "options": {
        "baseURL": "https://api.muapi.ai/v1",
        "apiKey": "{env:MUAPI_API_KEY}"
      },
      "models": {
        "YOUR_MODEL_ID": { "name": "Muapi text model" }
      }
    }
  }
}

将 YOUR_MODEL_ID 替换为 Muapi 模型列表中的准确 ID。API 密钥应保存在环境变量中，不要写入共享或提交到仓库的配置文件。

3. 选择模型

启动 OpenCode，运行 /models，然后在 Muapi 提供商下选择模型。先尝试一个小型编程任务，确认 OpenCode 可以读取并修改文件。

故障排查

• 若 /models 中没有 Muapi，请检查配置语法、模型 ID，以及 OpenCode 是否能读取配置文件。
• 若出现身份验证错误，请确认启动 OpenCode 的环境中已设置 MUAPI_API_KEY。
• 若模型无法调用工具，请选择 Muapi 模型列表中 capabilities.tools: true 的模型。
• 大型代码库提示可能很快消耗积分。请从小任务开始，并在 Muapi 控制台查看用量。

自定义提供商配置选项请参阅 OpenCode 提供商文档。