U9 AI · DOCUMENTATION

Cherry Studio 接入指南

Cherry Studio 配置入口、地址填写、模型选择、验收步骤和 MD 下载。

下载 MD 文档 ↓

适用范围与前提#

本页提供 Cherry Studio 对接本站的配置说明。需要启用的本站密钥、可用余额以及协议匹配的实际可用模型。2026-10-24 已核对官方资料;这不代表每个客户端版本及上游模型都已完成全流程测试。

配置步骤#

  1. 进入 Settings → Model Provider,添加自定义供应商,名称设为 U9 AI。
  2. 选择 OpenAI 兼容类型,填写 API Key 和 API Host。
  3. 同步模型或手动添加本站实际模型 ID,仅勾选已确认可用的能力。
  4. 使用模型检测,然后新建聊天选择 U9 AI 下的模型。

配置值对照#

配置项填写内容
API Hosthttps://u9ai.ai
API KeyYOUR_U9AI_API_KEY · 本站 API 密钥
ModelYOUR_CHAT_MODEL_ID · 实际可用模型 ID
最终文本请求端点https://u9ai.ai/v1/chat/completions

这个工具需要特别注意#

核对最终请求路径应为 /v1/chat/completions,避免重复 /v1。这里配置普通聊天;Cherry Agent 的协议要求不同,不能因为聊天连通就宣称 Agent 已兼容。

验收与交接#

先按快速开始执行只读 GET /v1/models,确认认证和目录。再分别验收短文本非流式请求、流式输出及所需的完整工具调用往返。生成测试可能扣费,请保留请求号并核对消费分析。失败时在工单提供客户端版本、模型 ID、端点、状态码和脱敏错误;超时任务不要盲目重提。

可将本 MD 直接交给开发者或 Agent 阅读,要求保留原配置、只替换实际可用模型,并明确报告未验证项。真实密钥不要写入共享 MD。

官方参考#

Cherry Studio

对于会自动补全 /v1/chat/completions 的 API Host,填写根地址 https://u9ai.ai。如果版本要求按协议填写版本基址,以页面的请求路径预览为准。以 / 结尾只追加 chat/completions;以 # 结尾表示固定完整请求地址。最终预览必须为 https://u9ai.ai/v1/chat/completions。保存后记得启用供应商开关。

API Host settings

← 使用文档