# Passion8 常见问题：API Key、模型、连接与计费

> Passion8 接入高频问题 — Base URL、模型、计费、鉴权报错与和官方的区别。

URL: https://docs.passion8.cc/docs/faq
Language: zh-CN
Publisher: Passion8
Last updated: 2026-10-11

接入 Passion8 时最常遇到的问题都在这里。找不到答案可以看对应客户端的「常见问题」页,或联系客服。邀请链接和话术见 [邀请奖励](https://docs.passion8.cc/docs/invite)。


### 



### Base URL 到底带不带 /v1?

看客户端:

- **Gemini CLI**:`https://passion8.cc`,**不带** `/v1`。
- **Claude Code**:`https://passion8.cc`,**不带** `/v1`。
- **Codex / Grok / OpenAI 兼容**:`https://passion8.cc/v1`,**带** `/v1`。

带错 `/v1` 是最常见的连不上原因。





### 支持哪些模型?

以 [控制台模型广场](https://passion8.cc) 实际可用的为准 —— 覆盖 Anthropic(Claude)、OpenAI(GPT / Codex)、Gemini 等主流模型。模型名请直接复制模型广场里的 ID。





### 计费和官方一样吗?

与官方**等比折算**,没有隐藏费用。用量、单价、缓存都能在控制台对账,和官方账单对得上。详见 [充值与账单](https://docs.passion8.cc/docs/billing)。





### 报 401 / 鉴权失败怎么办?

依次检查:

1. Key 是否复制完整、有没有多余空格;
2. Base URL 是否带错 `/v1`;
3. Key 是否放对位置(Claude 用环境变量 / `settings.json`,Codex 放 `~/.codex/auth.json`,Grok Build 放 `~/.grok/config.toml`,Gemini CLI 放 `~/.gemini/.env`);
4. 改完配置有没有**重启工具或新开终端**。





### 提示模型不存在 / model not found?

先把模型名换成 [模型广场](https://passion8.cc) 里实际可用的 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 是否正确 | 对照 [快速开始](https://docs.passion8.cc/docs/quickstart) 和控制台模型列表 |
| 429 / rate limited | 当前并发、渠道限额或余额状态 | 降低并发，按服务返回的重试提示等待，避免循环重试 |
| 5xx / timeout | 当前 [服务状态](https://status.passion8.cc/) 和本地网络 | 保存请求时间、模型和脱敏错误；不公开请求内容或凭据 |

相同状态码可能来自不同环节，以上是排查顺序，不代表对每次错误的确定诊断。费用问题参阅 [充值与账单](https://docs.passion8.cc/docs/billing)。