> ## Documentation Index
> Fetch the complete documentation index at: https://apione.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenCode 接入 APIONE

> 使用 OpenAI 兼容提供商连接 APIONE。

## 接入配置

### 1. 准备 APIONE 配置

在 [APIONE 密钥页](https://apione.ai/zh/app/api-keys)创建 API Key，选择可用分组。在[模型目录](https://apione.ai/docs/models/catalog.md)查询当前 Key 支持的实际模型 ID，并确认模型支持 Chat Completions 和工具调用。

| 配置 | 内容 |
| - | - |
| 提供商 ID | `apione` |
| 提供商名称 | `APIONE` |
| Base URL | `https://api.apione.ai/v1` |
| API Key | 自己的 APIONE API Key |
| 模型 ID | 当前 Key 可调用的实际模型 ID |

### 2. 确认版本与配置文件

桌面端在 **设置 → 关于** 查看版本，命令行运行 `opencode --version`。按正在使用的版本填写下方配置。

打开用户目录中的 `.config/opencode/opencode.jsonc`，或在当前项目中使用 `opencode.json`。修改前备份已有文件，再合并 APIONE 配置。桌面端未提供自定义服务商入口时，直接编辑配置文件。

### 3. 配置 OpenCode 2.x

在配置文件中添加 APIONE 提供商，将模型占位符替换为实际 ID。

```json theme={null}
{
  "$schema": "https://opencode.ai/config.json",
  "providers": {
    "apione": {
      "name": "APIONE",
      "env": ["APIONE_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": {
        "baseURL": "https://api.apione.ai/v1"
      },
      "models": {
        "YOUR_APIONE_MODEL_ID": {"name": "APIONE model"}
      }
    }
  }
}
```

在启动 OpenCode 的环境中设置 `APIONE_API_KEY`。Windows PowerShell 可使用以下命令，然后从同一终端启动 OpenCode 命令行。

```powershell theme={null}
$env:APIONE_API_KEY = "YOUR_APIONE_KEY"
opencode
```

桌面端需要其服务进程能够读取该变量。Windows 可在系统的 **环境变量 → 用户变量** 中添加 `APIONE_API_KEY`，保存后完全退出并重新打开 OpenCode。

### 4. 配置 OpenCode 1.x

在 OpenCode 中运行 `/connect`，选择 **Other**，提供商 ID 填 `apione`，输入 APIONE API Key。然后在配置文件中合并以下内容。

```json theme={null}
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "apione": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "APIONE",
      "options": {"baseURL": "https://api.apione.ai/v1"},
      "models": {
        "YOUR_APIONE_MODEL_ID": {"name": "APIONE model"}
      }
    }
  }
}
```

将模型占位符替换为实际 ID。提供商 ID `apione` 与保存密钥时填写的 ID 保持一致。

## 配置提供商与模型

在对应版本的 `models` 对象中，以实际模型 ID 为键添加模型。需要多个模型时，为每个模型增加一项，并保存配置。模型的上下文、输出上限及图片能力按 APIONE 模型参数设置。

## 选择模型

重启 OpenCode，打开模型选择器，或在支持命令的界面运行 `/models`。选择 **APIONE** 下的模型并发送“只回复 OK”，再到 [APIONE 控制台](https://apione.ai/zh/app)核对请求状态、模型与用量。

完成文本验证后，再在测试项目中让模型读取文件并解释目录结构，确认工具调用可用。

![OpenCode 的已连接提供商列表中显示 apione，并标注已通过环境变量连接](https://mintcdn.com/apione/JSBwBgVVuvXGE77Q/images/integrations/screenshots/opencode-apione-connected.png?fit=max\&auto=format\&n=JSBwBgVVuvXGE77Q\&q=85\&s=3cc6a5f2e5e4b4de6c7943e787e7da7f)

OpenCode 提供商页面显示 APIONE 已通过环境变量连接。

在 **设置 → 提供商** 中确认 APIONE 出现在已连接列表。随后选择模型发送消息，并到 APIONE 请求明细核对调用结果。

![OpenCode 会话中显示 APIONE OpenCode visible success 回复](https://mintcdn.com/apione/kQjSwlZGfL2mAyXv/images/integrations/screenshots/opencode-apione-chat-reply-v2.png?fit=max\&auto=format\&n=kQjSwlZGfL2mAyXv\&q=85\&s=b1fbba69b7f912aef530ebc965247c55)

OpenCode 会话中通过 APIONE 返回的文本回复示例。

完成对话后，在 APIONE 请求明细中核对模型和用量，实际扣费以 APIONE 账单为准。

## 排查

| 现象 | 处理 |
| - | - |
| APIONE 未出现 | 核对配置文件位置、版本对应字段，重启当前客户端或服务 |
| 找不到模型 | 核对 `models` 中的实际模型 ID 和当前 Key 权限 |
| 401 | 检查凭据来源、变量是否被服务进程读取及 Key 状态 |
| 404 | 核对 Base URL 与最终请求路径 |
| 能聊天但任务失败 | 检查模型的工具能力、上下文和请求参数 |

配置字段见 [OpenCode 当前版本说明](https://opencode.ai/docs/providers/)和 [OpenCode 1.x 说明](https://opencode.ai/v1/docs/providers/)。

***

[返回集成目录](https://apione.ai/docs/guides/clients.md) · [模型选择](https://apione.ai/docs/models/catalog.md) · [错误排查](https://apione.ai/docs/support/errors.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.