> ## 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.

# 客户端与工具集成

> 选择你的客户端，按 APIONE 专用教程配置密钥、接口和模型。

APIONE 提供 OpenAI、Anthropic 和 Gemini 兼容接口。先选择正在使用的客户端，再按对应教程填写地址与模型；同一个字段在不同软件中可能表示根地址、Base URL 或完整请求 URL。

![APIONE 客户端接入准备页面](https://mintcdn.com/apione/pAFvFGkbmcRZirTZ/images/ui/api-keys-overview.png?fit=max\&auto=format\&n=pAFvFGkbmcRZirTZ\&q=85\&s=286a882ab53c81ad3bd16d56c6487dc9)

APIONE API Key 页面提供 Base URL、协议说明、模型价格与客户端下载入口。

## 开始前准备

1. 在 [APIONE 控制台](https://apione.ai/zh/app/api-keys) 创建 API Key。
2. 从 [模型目录](https://apione.ai/zh/models) 选择模型，并确认当前密钥拥有访问权限。
3. 复制实际模型 ID。教程中的 YOUR\_APIONE\_KEY 和 YOUR\_APIONE\_MODEL\_ID 是占位符，使用前必须替换。
4. 先完成简单文字对话，再逐项测试流式输出、图片和工具调用。

## 编程助手与命令行

> [card] [CC-Switch](https://apione.ai/docs/guides/cc-switch.md)
>
> 在图形界面中保存 APIONE 配置，按工具切换供应商。

> [card] [Claude Code](https://apione.ai/docs/guides/claude-code.md)
>
> 设置 Anthropic 兼容地址，在终端与 VS Code 中使用 APIONE。

> [card] [Claude Desktop](https://apione.ai/docs/guides/claude-desktop.md)
>
> 配置 APIONE 的 Anthropic Messages 兼容接口。

> [card] [Cline](https://apione.ai/docs/guides/cline.md)
>
> 在编辑器中配置 OpenAI Compatible 模型服务。

> [card] [Codex CLI 与桌面端](https://apione.ai/docs/guides/codex.md)
>
> 通过自定义 Responses Provider 配置 APIONE。

> [card] [Cursor](https://apione.ai/docs/guides/cursor.md)
>
> 设置自定义 OpenAI 地址并验证聊天模型。

> [card] [DeepSeek Harness](https://apione.ai/docs/guides/deepseek-harness.md)
>
> 以 API Key 和自定义基础地址配置 DSH。

> [card] [Gemini CLI](https://apione.ai/docs/guides/gemini-cli.md)
>
> 使用 Gemini 兼容接口，在命令行中调用 APIONE 模型。

> [card] [GitHub Copilot](https://apione.ai/docs/guides/github-copilot.md)
>
> 通过 VS Code 的自定义模型端点配置 APIONE。

> [card] [Hermes Agent](https://apione.ai/docs/guides/hermes-agent.md)
>
> 以自定义 OpenAI 兼容端点配置 Hermes Agent。

> [card] [Neovate Code](https://apione.ai/docs/guides/neovate-code.md)
>
> 配置自定义提供商，在 Neovate Code 中使用 APIONE。

> [card] [OpenCode](https://apione.ai/docs/guides/opencode.md)
>
> 使用 OpenAI 兼容提供商连接 APIONE。

> [card] [Pi Coding Agent](https://apione.ai/docs/guides/pi-coding-agent.md)
>
> 使用自定义 Provider 和 API Key 配置 Pi。

## 聊天、笔记与工作流

> [card] [Cherry Studio](https://apione.ai/docs/guides/cherry-studio.md)
>
> 添加 OpenAI 兼容服务，在桌面端选择 APIONE 模型聊天。

> [card] [Dify](https://apione.ai/docs/guides/dify.md)
>
> 为工作区添加模型，在 Chatbot 与工作流中调用 APIONE。

> [card] [Obsidian Copilot](https://apione.ai/docs/guides/obsidian.md)
>
> 在笔记工作区中配置 APIONE 聊天模型。

> [card] [Open WebUI](https://apione.ai/docs/guides/open-webui.md)
>
> 通过管理员连接设置添加 APIONE 模型。

> [card] [RikkaHub](https://apione.ai/docs/guides/rikkahub.md)
>
> 在 Android 聊天客户端中添加 APIONE 服务商。

> [card] [Sider](https://apione.ai/docs/guides/sider.md)
>
> 在支持自定义 API 的 Sider 版本中使用 APIONE。

## Agent 部署与通用配置

> [card] [OpenClaw](https://apione.ai/docs/guides/openclaw.md)
>
> 为 OpenClaw 添加 APIONE 自定义模型提供商。

> [card] [阿里云 OpenClaw](https://apione.ai/docs/guides/openclaw-alibaba.md)
>
> 先验证服务器上的模型连接，再接入网关与消息渠道。

> [card] [网络环境](https://apione.ai/docs/guides/network-environments.md)
>
> 排查本机、代理、容器和远程服务中的连接问题。

> [card] [OAuth PKCE](https://apione.ai/docs/guides/oauth-pkce.md)
>
> 了解 APIONE 当前认证方式与 OAuth 集成的边界。

## 接口地址速查

| 接口 | 常用 Base URL | 完整请求路径示例 |
| - | - | - |
| OpenAI Chat Completions | `https://api.apione.ai/v1` | `/v1/chat/completions` |
| [OpenAI Responses](https://apione.ai/docs/api/responses.md) | `https://api.apione.ai/v1` | `/v1/responses` |
| Anthropic Messages | `https://api.apione.ai` | `/v1/messages` |
| [Gemini](https://apione.ai/docs/api/gemini.md) | `https://api.apione.ai/v1beta` | `/v1beta/models/{model}:generateContent` |

如果客户端自动拼接版本号，应填写根地址；例如 Gemini CLI 的 GOOGLE\_GEMINI\_BASE\_URL 使用 `https://api.apione.ai`。最终请求路径中只应出现一次 API 版本。具体以各教程为准。

## 通用 OpenAI 兼容配置

1. 打开模型提供商设置，选择自定义 OpenAI 兼容提供方，名称填写 APIONE。
2. 填写 APIONE API Key；Base URL 使用 `https://api.apione.ai/v1`。
3. 如果要求完整端点，填写 `https://api.apione.ai/v1/chat/completions`。
4. 若 Host 与 Path 分开，分别填写 `https://api.apione.ai` 和 `/v1/chat/completions`。
5. 添加实际模型 ID，保存后新建会话测试。

## Loomy

1. 打开 **设置 → 模型 → 服务商配置**，点击 **添加服务商**。
2. 供应商 ID 可填 `apione`，显示名称填 **APIONE**，SDK 模式选 **OpenAI Compatible**，Base URL 填 `https://api.apione.ai/v1`。
3. 点击 **下一步**，填入 APIONE API Key，点击 **从 API 获取**，选择模型后保存并应用。

![Loomy 的自定义供应商名称、兼容协议和 APIONE Base URL](https://mintcdn.com/apione/zM1w3ic8px2lIvc_/images/integrations/screenshots/loomy-apione-provider.png?fit=max\&auto=format\&n=zM1w3ic8px2lIvc_\&q=85\&s=4109974fe40ce45d3d04432cc8c14f5e)

Loomy 新增 APIONE 自定义供应商的配置示例。

![Loomy 已遮盖的 API Key 和从 API 获取模型按钮](https://mintcdn.com/apione/zM1w3ic8px2lIvc_/images/integrations/screenshots/loomy-api-key-models.png?fit=max\&auto=format\&n=zM1w3ic8px2lIvc_\&q=85\&s=eb337d082aba6464259741c3f57ee517)

Loomy 的 API Key 输入框和获取模型入口。

## Zed

1. 打开 **AI 设置 → LLM Providers**，点击 **Add Provider**。
2. 为 Zed 自带的 Agent 添加 OpenAI 兼容供应商。供应商名称填 **APIONE**，API URL 填 `https://api.apione.ai/v1`，API Key 填 APIONE 密钥。
3. 添加实际可用的模型 ID。保存后，在 Zed Agent 中选择该模型发送一条测试消息。

![Zed AI 设置中添加模型供应商的入口](https://mintcdn.com/apione/zM1w3ic8px2lIvc_/images/integrations/screenshots/zed-add-provider-entry.png?fit=max\&auto=format\&n=zM1w3ic8px2lIvc_\&q=85\&s=9949a31fb45a6415502799df87bcae71)

Zed 的 LLM Providers 区域和 Add Provider 入口。

## Kilo Code

1. 打开扩展的 **Settings → Providers → Custom provider**。
2. Provider ID 可填 `apione`，Display name 填 **APIONE**。使用 Chat Completions 模型时，Provider API 选 **OpenAI Compatible**，Base URL 填 `https://api.apione.ai/v1`，API Key 填 APIONE 密钥。
3. 获取或手动添加可用模型，保存后在聊天中选中该模型发送测试消息。

![Kilo Code 自定义供应商表单中的 APIONE Base URL 和 API Key 字段](https://mintcdn.com/apione/zM1w3ic8px2lIvc_/images/integrations/screenshots/kilo-code-apione-provider.png?fit=max\&auto=format\&n=zM1w3ic8px2lIvc_\&q=85\&s=66ca33c68d7deed313b333fed5a1ce24)

Kilo Code 自定义供应商的配置示例。

## LobeHub

1. 在 **设置 → AI 服务商** 中创建自定义服务商，唯一标识可填 `apione`，服务商名称填 **APIONE**。
2. 请求格式选择 **OpenAI**，代理地址填 `https://api.apione.ai/v1`，输入 APIONE API Key 后点击 **新建**。
3. 添加实际可用的模型 ID，在聊天中选用该模型并发送测试消息。

![LobeHub 自定义服务商表单中的 OpenAI 请求格式、APIONE 代理地址和密钥字段](https://mintcdn.com/apione/l_tpyU_NU9GJriKq/images/integrations/screenshots/lobehub-apione-provider.png?fit=max\&auto=format\&n=l_tpyU_NU9GJriKq\&q=85\&s=8ae8ea8deb2b2f784bedb9499e986a15)

LobeHub 自定义服务商的配置示例。供应商标识可填写 apione。

## ExtraBrain

1. 打开 **Settings → AI Providers → Custom Provider**。
2. 填入 APIONE API Key 和 Base URL `https://api.apione.ai/v1`。**Model Name** 填 APIONE 模型目录中的实际模型 ID。
3. 点击 **Validate** 检查配置。通过后按需设置为主或备用供应商。

![ExtraBrain 的 APIONE Base URL、模型名称与 Validate 按钮](https://mintcdn.com/apione/l_tpyU_NU9GJriKq/images/integrations/screenshots/extrabrain-apione-provider.png?fit=max\&auto=format\&n=l_tpyU_NU9GJriKq\&q=85\&s=183e33ea1f2462dae435dc0d70da79fc)

ExtraBrain 自定义服务商的配置示例。请将图中的模型占位名替换为实际模型 ID。

## 验证与排错

“测试连接”不一定与实际对话走相同接口。请再发送一次真实请求，并核对 APIONE 请求记录。遇到问题，依次检查最终 URL、协议、模型 ID、密钥权限和余额。客户端订阅功能、OAuth 登录及专属扩展不属于通用接口兼容范围。

客户端版本可能改变入口名称。请按当前界面找到对应字段，并以本文的 APIONE 配置为准。

相关：[SDK 接入](https://apione.ai/docs/guides/sdks.md) · [迁移已有应用](https://apione.ai/docs/guides/migration.md) · [错误排查](https://apione.ai/docs/support/errors.md) · [常见问题](https://apione.ai/docs/support/faq.md)


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