AionUi 接入

难度 🧩 中等　|　接口格式 OpenAI 兼容　|　base_url https://byesu.com/v1

接入信息 · 填这几样

接口地址https://byesu.com/v1

API 密钥sk-xxxxxxxx去控制台创建 →

推荐模型gpt-5.5

接口格式 OpenAI 兼容 · 模型名以控制台实际为准

AionUi 是一款免费、本地、开源的 Cowork 桌面应用，带图形界面与远程 WebUI，可同时运行 Gemini CLI、Claude Code、Codex 等多个 AI 代理。给它配上半页酥 API 的模型，就能在一个界面里用 gpt-5.5、claude-opus-4-8、gemini-3.1-pro-high 等模型协作干活。

开始之前

先到控制台 → 令牌创建一个 API 令牌（形如 sk-xxxx）。

创建时务必选对分组——分组决定了你能调用哪些模型、按什么价格计费。不确定选哪个？看选择分组。

第 1 步：下载安装 AionUi

前往 GitHub Releases 页面，按你的系统下载对应安装包：

下载地址：https://github.com/iOfficeAI/AionUi/releases
Windows 选 .exe，macOS 选 .dmg，Linux 选 .AppImage。

下载后双击安装并打开 AionUi。

第 2 步：添加半页酥 API 模型

AionUi 用统一的模型配置接入 OpenAI 兼容服务，半页酥 API 即属于此类。

打开 AionUi，进入 设置（Settings） 页面。
切换到 模型配置（Model Configuration） 标签页。
点击 添加模型（Add Model）。
供应商类型选择 NewAPI（或 OpenAI 兼容 / Custom）。
按下表填写：

字段	填写内容
API 地址（API Address / base_url）	`https://byesu.com/v1`
API 密钥（API Key）	你的令牌 `sk-xxxx`
模型（Model）	见下方推荐
请求协议（Request Protocol）	选 OpenAI（兼容）；若添加 claude / gemini 模型后报协议或格式错误，按模型手动切换对应协议

base_url 末尾要带 /v1

OpenAI 兼容格式必须填 https://byesu.com/v1，不要漏掉 /v1，也不要在结尾多加斜杠或 /chat/completions。

填好密钥后，从模型下拉里勾选要用的模型；若列表为空，可手动输入模型名。常用模型：

用途	模型名
通用对话 / 写作	`gpt-5.5`
编码 / 长上下文推理	`claude-opus-4-8`
多模态 / 超大上下文	`gemini-3.1-pro-high`

保存配置。

第 3 步：（可选）配置 Claude Code 代理

AionUi 内每个 AI 代理可独立配置。其中 Claude Code 代理走 Anthropic 原生接口，base_url 与 OpenAI 兼容不同——不带 /v1：

Claude Code 代理设置等效环境变量

text

Base URL:  https://byesu.com
API Key:   sk-xxxx
Model:     claude-opus-4-8

bash

ANTHROPIC_BASE_URL=https://byesu.com
ANTHROPIC_AUTH_TOKEN=sk-xxxx
ANTHROPIC_MODEL=claude-opus-4-8

Gemini CLI、Codex 等其他代理同理，在各自的配置里填入对应的 base_url（OpenAI 兼容用 https://byesu.com/v1）、密钥与模型即可。

第 4 步：跑起来验证

回到聊天界面，在顶部模型选择处选中刚配置的模型（如 gpt-5.5），发送一句「你好，用一句话介绍你自己」。

能正常收到回复，说明接入成功。若用了 Claude Code 代理，可让它读一个文件或执行一个简单任务来确认代理工作正常。

卡住了？

401 / 无效令牌：检查 API Key 是否完整粘贴、有没有多余空格；确认用的是半页酥控制台里创建的 sk-xxxx。详见常见错误 #auth。
报无可用渠道 / 模型不存在：多半是令牌分组没选对，或填的模型名当前分组不支持。换个分组或换模型名，参考选择分组与常见错误 #no-channel。
余额不足：账户额度用尽会被拒绝，先充值或换分组。见常见错误 #balance。
连不上 / 404：确认 OpenAI 兼容填的是 https://byesu.com/v1，Claude Code 代理填的是 https://byesu.com（不带 /v1）。

更多排查见常见错误。

AionUi 接入 ​

第 1 步：下载安装 AionUi ​

第 2 步：添加半页酥 API 模型 ​

第 3 步：（可选）配置 Claude Code 代理 ​