聊天应用

了解如何使用 SurgeAI API 配置 CherryStudio、Chatbox、Promply 等热门聊天应用

🎯 如何配置聊天应用？

按照以下简单指南，将 SurgeAI 集成到您喜爱的聊天应用中

🔧 步骤 1：选择兼容工具

选择一个支持自定义 AI 提供商的聊天应用。我们推荐以下热门选项：

应用	说明
CherryStudio	功能丰富的聊天客户端，插件支持出色
Chatbox	轻量快速的桌面应用
Promply	专业 AI 提示管理工具
ChatWise	任何 OpenAI 兼容客户端都可以！

💡 专业提示：大多数 OpenAI 兼容的聊天客户端都可以与 SurgeAI 无缝配合。只需在设置中查找"自定义 API"或"OpenAI 兼容"选项。

📥 步骤 2：安装 SurgeAI 提供商

📖 以 CherryStudio 为例

以下步骤演示 CherryStudio 的设置过程。其他应用遵循类似的模式。

打开设置 - 启动您的聊天应用，进入设置或 首选项 菜单。通常在顶部菜单栏或侧边栏中。

添加新提供商 - 查找以下选项：

"添加提供商" 或 "新建提供商"

"自定义模型" 或 "模型配置"

"API 设置" 或 "API 配置"

选择 SurgeAI - 从提供商列表中选择 SurgeAI，或者如果 SurgeAI 未预置，选择 "自定义 OpenAI 兼容 API"。

💡 不同应用的菜单名称可能有所不同，但概念相同：添加自定义 API 提供商并使用 SurgeAI 的端点进行配置。

🔑 步骤 3：输入 API 凭据

配置您的连接，输入以下两个必需参数：

Base URL（必需）

https://surgeai.one/v1

所有 SurgeAI API 请求的基础端点 URL。请确保完全复制！

API Key（必需）

sk-your-api-key-here

您从 SurgeAI 控制台获取的唯一 API Key。请保密，切勿公开分享！

📋 配置示例

以下是 JSON 格式的典型配置示例：

{
  "provider": "SurgeAI",
  "baseURL": "https://surgeai.one/v1",
  "apiKey": "sk-your-api-key-here",
  "models": ["gpt-4", "gpt-3.5-turbo", "claude-3-opus"]
}

🔐 在哪里找到您的 API Key？
访问 SurgeAI 控制台并进入 API Keys 部分。您可以在那里创建新密钥或管理现有密钥。

⚠️ 安全提醒：切勿将 API Key 提交到版本控制系统或在公共论坛中分享。请像对待密码一样对待它们！

🚀 步骤 4：开始使用模型

🎉 一切就绪！

从下拉菜单中选择模型，开始创建精彩内容吧。

🔧 故障排除

🔴 连接错误

问题：无法连接到 SurgeAI API

解决方案：

✅ 验证您的 Base URL 是否正确：https://surgeai.one/v1（无尾部斜杠）

✅ 检查您的网络连接是否稳定

✅ 确保您的防火墙允许到 surgeai.one 的 HTTPS 连接

✅ 如果您正在使用 VPN，请尝试暂时禁用

✅ 检查您的公司网络是否阻止外部 API

🔐 认证失败 (401)

问题：收到"401 Unauthorized"错误

解决方案：

✅ 仔细检查您的 API Key 是否正确复制（无多余空格）

✅ 在控制台中验证您的 API Key 是否处于活动状态

✅ 如果旧密钥不起作用，请尝试重新生成新的 API Key

✅ 确保您使用的是正确的密钥格式：sk-...

✅ 检查您的 API Key 是否已被撤销或过期

💳 余额不足 (402/403)

问题："余额不足"或需要付款的错误

解决方案：

✅ 在控制台中检查您的账户余额

✅ 通过充值中心添加余额

✅ 查看您的使用限制和配额

✅ 确保您的付款方式有效且最新

🤖 模型不可用 (404)

问题：所选模型无响应或不可用

解决方案：

✅ 验证模型在您的订阅计划中是否可用

✅ 尝试切换到其他模型（如 GPT-3.5 Turbo）

✅ 查看状态页面了解服务更新

✅ 确保模型名称拼写正确

✅ 某些模型可能有地区限制

⚡ 响应缓慢

问题：API 响应非常慢

解决方案：

✅ 尝试使用更快的模型，如 GPT-3.5 Turbo

✅ 检查您的网络连接速度

✅ 减少请求中的 max_tokens 参数

✅ 考虑您与服务器的地理距离

✅ 检查服务是否有高负载（状态页面）

⚠️ 重要提示

🔒 安全最佳实践

切勿公开分享您的 API Key - 请像对待密码一样对待它

定期轮换密钥 - 每隔几个月生成新密钥

使用环境变量 - 切勿在代码中硬编码密钥

监控使用情况 - 定期检查控制台是否有异常活动

撤销泄露的密钥 - 立即禁用任何暴露的密钥

使用单独的密钥 - 开发和生产使用不同的密钥

🌐 网络要求

协议：仅 HTTPS（TLS 1.2 或更高）

端点：https://surgeai.one/v1

认证：请求头中需要 API Key

防火墙：确保允许出站 HTTPS（端口 443）

代理：如果您的网络使用代理服务器，请配置

CORS：已为 Web 应用预配置

📚 其他资源

资源	说明
📖 API 文档	完整的 API 参考，包含所有端点、参数和示例
🎛️ 控制台	管理 API Key、监控使用情况和查看分析
💰 充值中心	查看定价、添加余额和管理订阅
💬 支持	获取我们团队的帮助以解决集成问题

🎯 下一步

准备好探索更多了吗？以下是一些推荐的后续步骤：

下一步	说明
🤖 探索所有模型	浏览我们完整的 AI 模型目录，包括聊天、图像、视频和音频生成
💻 API 参考	深入了解 API 端点、参数和集成模式
💵 查看定价	查看具有竞争力的定价并选择最适合您需求的计划

🚀 准备好构建出色的应用了吗？

加入数千名使用 SurgeAI 为 AI 应用提供支持的开发者

🎯 如何配置聊天应用？#

🔧 步骤 1：选择兼容工具#

📥 步骤 2：安装 SurgeAI 提供商#

📖 以 CherryStudio 为例#

🔑 步骤 3：输入 API 凭据#

Base URL（必需）#

API Key（必需）#

📋 配置示例#

🚀 步骤 4：开始使用模型#

🔧 故障排除#

🔴 连接错误#

🔐 认证失败 (401)#

💳 余额不足 (402/403)#

🤖 模型不可用 (404)#

⚡ 响应缓慢#

⚠️ 重要提示#

🔒 安全最佳实践#

🌐 网络要求#

📚 其他资源#

🎯 下一步#

🎯 如何配置聊天应用？

🔧 步骤 1：选择兼容工具

📥 步骤 2：安装 SurgeAI 提供商

📖 以 CherryStudio 为例

🔑 步骤 3：输入 API 凭据

Base URL（必需）

API Key（必需）

📋 配置示例

🚀 步骤 4：开始使用模型

🔧 故障排除

🔴 连接错误

🔐 认证失败 (401)

💳 余额不足 (402/403)

🤖 模型不可用 (404)

⚡ 响应缓慢

⚠️ 重要提示

🔒 安全最佳实践

🌐 网络要求

📚 其他资源

🎯 下一步