常见问题
先确认这三项
绝大多数接入失败由以下原因导致，建议按顺序核对：
三项自查
- 接口地址是否以
/v1结尾：应为https://ai.youyiyun.cn/v1。 - 密钥是否完整：重新复制
sk-开头的完整密钥，确认首尾无空格。 - 余额是否充足：左侧「钱包」查看余额，为 0 时请求必然失败。
状态码对照
| 现象 | 可能原因 | 处理方式 |
|---|---|---|
404 / 接口不存在 | 接口地址缺少 /v1，或客户端附加了多余路径 | 改为 https://ai.youyiyun.cn/v1 后重试 |
401 / 未授权 | 密钥错误、已删除或复制不完整 | 重新创建并复制完整密钥 |
403 / 无权限 | 当前密钥分组不可使用该模型 | 更换分组内可用模型，或调整令牌分组 |
429 / 请求过多 | 触发限流 | 降低并发或稍后重试，必要时开启跨分组重试 |
| 余额不足 / 额度耗尽 | 钱包余额为 0 | 充值或使用兑换码 |
| 获取模型列表失败 | 密钥、地址或网络异常 | 先在浏览器确认站点可访问，再核对密钥与地址 |
| 模型列表为空 | 当前分组无可用模型 | 在模型广场确认模型存在，检查密钥分组 |
| 可选择模型但对话报错 | 接口协议错误或模型 ID 不正确 | 协议改回 OpenAI Chat Completions，模型 ID 从模型广场复制 |
| cc-switch 启用后无变化 | 客户端未重启，或启用了其他供应商 | 完全退出客户端后重开，确认 优益AI 显示「使用中」 |
| 请求持续超时 | 本地网络或线路异常 | 稍后重试，或加入 QQ 群确认站点状态 |
分类排查
可自定义供应商的客户端（DeepSeek 等）
- 接口协议必须为 OpenAI Chat Completions。
- 接口地址填写
https://ai.youyiyun.cn/v1，不要填写站点首页。 - 先点击「获取可用模型」再创建供应商；无法获取即说明密钥或地址有误。
- 创建后需在聊天界面模型选择器中选中对应模型，否则将回退至默认模型。
不可自定义供应商的客户端（cc-switch）
- 供应商类型选择「自定义配置」，不要选择「账号登录」。
- API 请求地址必须包含
/v1。 - 模型列表仅保留模型广场中确实存在的模型 ID。
- 点击「启用」后必须重启客户端，否则配置不生效。
密钥与计费
密钥请勿外泄
API 密钥等同账户余额，请勿提交至代码仓库、发送至群聊或出现在截图中。如确认泄露，请在「API 密钥」页面删除并重新创建。
- 模型价格差异较大，接入前请在 模型广场 确认单价。
- 客户端显示的费用为估算值，实际扣费以站点后台用量记录为准。
- 建议先用低价模型验证链路，再切换至更强模型。
仍无法解决
完成上述排查后仍无法接入，请联系技术支持：
该群提供提问模板与排查信息清单，见 技术支持页面。