Passion8
常见问题
Passion8 接入高频问题 — Base URL、模型、计费、鉴权报错与和官方的区别。
接入 Passion8 时最常遇到的问题都在这里。找不到答案可以看对应客户端的「常见问题」页,或联系客服。邀请链接和话术见 邀请奖励。
详情
Base URL 到底带不带 /v1?
看客户端:
- Gemini CLI:
https://passion8.cc,不带/v1。 - Claude Code:
https://passion8.cc,不带/v1。 - Codex / Grok / OpenAI 兼容:
https://passion8.cc/v1,带/v1。
带错 /v1 是最常见的连不上原因。
支持哪些模型?
以 控制台模型广场 实际可用的为准 —— 覆盖 Anthropic(Claude)、OpenAI(GPT / Codex)、Gemini 等主流模型。模型名请直接复制模型广场里的 ID。
计费和官方一样吗?
与官方等比折算,没有隐藏费用。用量、单价、缓存都能在控制台对账,和官方账单对得上。详见 充值与账单。
报 401 / 鉴权失败怎么办?
依次检查:
- Key 是否复制完整、有没有多余空格;
- Base URL 是否带错
/v1; - Key 是否放对位置(Claude 用环境变量 /
settings.json,Codex 放~/.codex/auth.json,Grok Build 放~/.grok/config.toml,Gemini CLI 放~/.gemini/.env); - 改完配置有没有重启工具或新开终端。
提示模型不存在 / model not found?
先把模型名换成 模型广场 里实际可用的 ID(Codex 还要确认该模型支持 Responses API)。
如果模型名没错还是报不存在,多半是令牌分组问题:创建令牌时不要用默认分组,要选中包含该模型的具体分组。默认分组不一定覆盖你要用的模型。
支持流式、工具调用、缓存吗?
支持。Passion8 透传官方协议,流式响应、工具调用、上下文缓存等特性和直连官方一致,SDK 不用改。
和直连官方有什么区别?
接入方式几乎一样 —— 只换 base_url 和 Key。区别在于:国内可直连、支持卡密充值、多线路加速、请求日志与用量可观测。协议层完全兼容。
#按错误快速定位
| 现象 | 先检查什么 | 下一步 |
|---|---|---|
| 401 / invalid API key | 客户端是否读取了正确的 Passion8 Key；旧环境变量是否覆盖配置 | 在本机更新凭据后重试，不向客服发送完整 Key |
| 403 / permission denied | 令牌分组、模型权限与客户端要求是否一致 | 在控制台检查令牌权限，结合请求时间与脱敏错误联系客服 |
| 404 / model not found | Base URL 的 /v1 与模型 ID 是否正确 | 对照 快速开始 和控制台模型列表 |
| 429 / rate limited | 当前并发、渠道限额或余额状态 | 降低并发，按服务返回的重试提示等待，避免循环重试 |
| 5xx / timeout | 当前 服务状态 和本地网络 | 保存请求时间、模型和脱敏错误；不公开请求内容或凭据 |
相同状态码可能来自不同环节，以上是排查顺序，不代表对每次错误的确定诊断。费用问题参阅 充值与账单。
支持
需要帮助？
接入、计费与模型异常可邮件联系；服务可用性以状态页为准。
也可使用右下角微信 / QQ 客服。
