🗝️ API Key 配置指南 (全平台通用)

拿到 sk- 开头的密钥后，请下载或打开下方推荐的软件，填入参数即可使用。

⚠️ 核心参数 (必读)

无论使用哪个软件，设置里只需要填这三项，其他默认即可：

1. 服务商 (Provider): 选择 OpenAI (或者 OpenAI 兼容/自定义)

   注意：不要选其他的，所有第三方 Key 走的都是 OpenAI 协议标准。

2. API 地址 (Host/URL): https://xxx.xxxxxx.xxx/v1

   请复制购买渠道提供的 API 地址，不要自己瞎改，注意结尾有没有 /v1

3. API Key (密钥): sk-xxxxxxxxxxxxxxxxxxxx

   复制你获得的那串字符

💻 电脑端 (Windows / Mac)

🍒 Cherry Studio (首选推荐)

目前功能最全、速度最快的桌面客户端。

• 下载地址: 官网下载 (Cherry-AI.com)
• 配置步骤:
  1. 点击页面上的【设置】小齿轮 -> 【模型服务】。
  2. 最下面 + 号 添加新的提供商。
  3. 提供商名称任意填写，提供商类型选 OpenAI。
  4. 填入你获得的 API Key 和对应的 API 地址。
  5. 点击【管理】添加你喜欢的模型（如 gpt-4o, claude-3-5-sonnet）。
  6. 返回对话页面，顶部切换到刚刚添加的模型即可开始对话。
• 👉 点击查看详细图文教程-等待装修

🌐 手机/平板/通用 (免安装 Web 版)

手机端（安卓/苹果）推荐直接使用网页版，可添加到主屏幕当 App 用，体验一致且无视系统限制。

选项 1：Chatbox Web (颜值高)

• 访问地址: https://web.chatboxai.app/
• 配置:
  1. 登录可直接跳过，点击左侧菜单下方的【Settings】(设置)。
  2. 点下最下面的 +ADD 添加第三方的服务商
  3. Model Provider (模型提供方) 选 OpenAI API Compatible (OpenAI 兼容)。
  4. 填入 API Host (地址) 和 API Key。
  5. 注意：请勿修改其他参数！
• 提示：如要启用模型的视觉识别（传图功能），请先对新添加的模型完成一次测试，Chatbox 才会识别该模型拥有视觉能力。
• 测试方式：点击新添加的模型右侧齿轮。 点击 Test Model 等待测试完成。 Save 保存接口。测试完成的模型才能在对话中传图分析。
• 👉 点击查看详细图文教程

⚠️ 常见问题与避坑 (必读)

• 👉 点我查看 AI使用常见注意事项

如果遇到报错，99% 是以下原因造成的，请先自查：

1. 出现 429 错误 / 请求被拒绝

• 原因：通常是你使用了**“上古毒瘤预设”**。
• 解释：很多几年前的复杂预设（Prompt）包含大量无效或对抗性指令，会导致接口风控拦截或触发速率限制。
• 解决：请关闭所有预设/插件，使用纯净模式对话。 现在的模型已经很聪明了，不需要那些乱七八糟的咒语。 或者利用ai 修正自己的预设/角色卡

2. 消息发不出去 / 空回复 / 超时

• 原因：上下文过长或内容触发安全机制或错误的参数等设置。
• 解决：
  • 清空上下文：开启新对话试试。
  • 检查内容：如果发送的内容包含大量敏感词或不合规描述，模型会直接“掐断”连接导致空回复。

3. 找不到模型 / 模型列表为空

• 原因：客户端没有自动同步模型列表。
• 解决：
  • 手动添加：在 Cherry Studio 或 Chatbox 的模型管理里，手动输入模型 ID（例如 gpt-4o 或 claude-3-5-sonnet）并添加，不需要等列表刷新。
  • 刷新列表：点击软件里的“刷新模型列表”按钮。

4. 回复特别慢 (关于推理模型)

• 现象：使用了 o1, r1 等深度思考 (Reasoning) 模型。
• 解释：这类模型在回答前需要几十秒的时间进行“思考”，这是正常现象。
• 建议：如果你只是日常闲聊，请使用 gpt-4o-mini 或 claude-3-haiku，速度会快飞起。