星桥Cherry Studio 配置 API 中转站：New API 地址与模型
在 Cherry Studio 使用星桥，可选择内置的 New API 服务商，填写根地址 https://newapi.xingqiaoapi.cn、星桥密钥和可用模型。这个地址不带 /v1，客户端会按照协议添加路径。
资料核对：。以下对照 Cherry Studio 官方 New API 教程；界面名称随版本变化，以你安装的版本为准。
1. 准备星桥密钥与模型
登录星桥控制台创建 API 密钥，在模型价格页确认模型和分组。保存完整模型 ID；模型名称、别名和展示名称不一定相同。密钥仅保存在你信任的客户端中，截图与分享配置时隐藏真实密钥。
2. 配置内置 New API 服务商
- 打开 Cherry Studio 的“设置 → 模型服务 → New API”。
- 在“API 密钥”填写星桥密钥。
- 在“API 地址”填写
https://newapi.xingqiaoapi.cn。 - 获取模型，或按完整模型 ID 手动添加目标模型。
- 执行检测并启用服务商，再在聊天中选择该服务商下的模型。
不要把 /chat/completions 等完整接口路径填进根地址。若旧配置中保留了其他协议的单独地址，应逐项检查，避免部分请求仍然发到旧服务。
New API 和自定义 OpenAI 的地址有什么不同？
| 配置方式 | 通常填写的地址 | 检查点 |
|---|---|---|
| 内置 New API | https://newapi.xingqiaoapi.cn | 客户端按协议管理版本路径。 |
| 要求 OpenAI Base URL 的配置 | https://newapi.xingqiaoapi.cn/v1 | 仍需按客户端版本确认是否自动追加版本。 |
不要只根据字段都叫“API 地址”就复制同一个值。最终请求应是 /v1/chat/completions 或该模型需要的协议路径，而不是 /v1/v1/chat/completions。
3. 用短对话检查实际调用
选择目标模型发送一句短消息，再核对星桥控制台的时间、模型、分组与费用。先测试普通文本，再逐项测试流式、图片、工具或知识库任务。知识库还可能需要独立的嵌入模型与重排模型，聊天模型可用不代表这些模型也已配置。
常见问题
获取到模型列表，为什么聊天仍然失败？
获取列表只证明该接口能返回模型。聊天还依赖模型权限、分组路由、协议与当前上游状态，需要根据实际状态码和错误代码继续排查。
检测出现 404，要重新创建密钥吗？
先检查地址是否重复包含 /v1、模型 ID 是否正确，以及选择的协议是否开放。404 不一定是密钥问题，重复创建密钥通常不能修复错误路径。
工具或图片不可用，要换成另一个模型吗？
先确认当前模型、分组和客户端都支持所需能力，再决定是否切换。不能仅凭模型名称判断所有渠道都具备同样的工具、图片或流式支持。
参考来源与下一步
Cherry Studio 官方：内置 New API 服务商。遇到错误参照401、429、503 排错指南；核对费用参照缓存与账单计算，其他客户端见工具接入指南。