SDK / 集成/应用集成

客户端接入

Cherry Studio、NextChat、Open WebUI 等桌面 / 自托管客户端的填写方式。

本页目录

凡是支持「自定义 OpenAI 接口」的客户端,都填同样的三项:

字段填什么
API 地址 / Base URLhttps://api.apione.ai/v1
API KeyYOUR_APIONE_KEY
模型模型 ID,例如 claude-sonnet-4-6

Cherry Studio

  1. 设置 › 模型服务 › 添加提供商,类型选 OpenAI。
  2. API 地址填 https://api.apione.ai/v1,API 密钥填你的 Key。
  3. 在「模型」里手动添加模型名,或点击「获取模型列表」自动拉取。

NextChat

  1. 设置 › 自定义接口,打开开关。
  2. 接口地址填 https://api.apione.ai(NextChat 会自行拼 /v1/chat/completions,若报 404 则改填带 /v1 的形式)。
  3. API Key 填你的 Key,自定义模型名填 claude-sonnet-4-6 等。

Open WebUI

  1. 管理面板 › 设置 › 外部连接 › OpenAI API。
  2. URL 填 https://api.apione.ai/v1,Key 填你的 Key,保存。
  3. 模型列表会自动从 GET /v1/models 拉取。

接不上时按这个顺序查

  1. 先用 curl 验证 Key 与地址本身没问题(见快速开始)。
  2. 确认地址是否需要带 /v1——不同客户端的拼接方式不同,两种都试一次。
  3. 模型 ID 是否拼写正确。
  4. 客户端是否设置了代理,导致请求没走到 api.apione.ai。
注意

把 Key 填进第三方客户端等于把消费权交给它。建议为客户端单独建一把只开放所需模型、设置了有效期的 Key(见API Key 管理),不要复用线上服务的 Key。

联系我们

文档没写清楚,或者需要人工协助?按问题类型选一个渠道即可。

邮箱

技术支持support@apione.ai

WhatsApp

Telegram

工单

计费与账户控制台 › 反馈