通用工具接入 汇飞智能 (OpenAI 兼容协议)
汇飞智能 的接口兼容标准的 OpenAI API 协议。这意味着，只要你使用的工具支持自定义 OpenAI 兼容节点（如 Cherry Studio、Chatbox、各类 VS Code 插件等），都可以将底层模型替换为 汇飞智能 的高性能算力。
注意：汇飞智能不提供 Claude/Anthropic 模型，也不是 Anthropic 协议端点，因此需要 Anthropic 协议的工具（如 Claude Code）无法按本文方式直接接入（Claude Code 请见 其专属教程）；下方示例一律使用非 Claude 模型。
一、通用配置“三要素”
无论你使用的是什么工具，找到其“设置 / API Configuration / Custom Provider”页面，替换以下三个核心参数：
二、实操演示（以 Cursor 为例）
以主流 AI 编程工具 Cursor 为例：
- 打开 Cursor，进入
Settings->Models。 - 找到 OpenAI 配置项，打开 Override OpenAI Base URL 开关，填入
https://api.sapis.cn/v1。 - 在 API Key 处填入你的 汇飞智能
sk-...密钥。 - 点击
Add Custom Model，输入你想使用的模型名（如deepseek-v4.1-flash）并开启开关。 - 在对话框选中该模型即可开始使用。
(图例参考)
三、通用排错指南 (FAQ)
如果你在配置后无法正常对话，请按以下顺序排查“三大经典报错”：
1. 报错 404 (Not Found) / Invalid URL / 模型不存在？ 这是最常见的路径或名称拼接错误：
- Base URL 结尾问题：先确认填的是
https://api.sapis.cn/v1；仅当某工具确实只接受根域名时才去掉/v1，并在该工具的文档中确认它是否需要自动补/v1。 - 模型名问题：不要凭直觉填写，必须确保填写的模型名在 汇飞智能 平台真实存在且你拥有调用权限。
2. 报错 401 (Unauthorized) / 认证失败？
- 检查 Key 是否多复制了空格，或者画蛇添足地加上了
Bearer前缀。 - 登录 汇飞智能 控制台确认该 API Key 的状态是否正常、额度是否充足。
3. 报错 502/504 / 网络连接超时？
- 可能是上游渠道瞬时波动。请稍后重试，或在模型广场切换到当前可用的其他模型重试。