# 常见问题

## 分组卡片上的"倍率"是什么意思?

倍率是该分组的**计费系数**:你的实际扣费 = 模型官方价格 × 分组倍率。

倍率越低越省钱。不同分组对应不同的上游来源,因此价格、可用模型、稳定性各有差异。

> 举例:某次调用官方计价 1 美元,分组倍率 0.5x,则实际扣费相当于 0.5 美元等值的余额。

各分组的当前倍率、支持的模型和价格,以控制台 **[api.clomio.ai](https://api.clomio.ai)** 实时显示为准。

---

## 实际扣费怎么算?

```text
实际扣费 = 模型官方价格 × 分组倍率
```

费用按 **token** 计量:你发出去的内容算"输入 token",模型返回的内容算"输出 token",两者分别计价。可以在控制台的「使用记录」里查看每一次调用的明细。

简单记一句:**说得越长、回得越长、轮次越多,token 越多,费用越高。** 命中缓存的部分会更便宜。

---

## 分组怎么选?

挑选时主要看三点:

- **倍率**:越低越省
- **支持的模型**:部分分组只支持特定模型
- **稳定性 / 速度**:不同分组的并发与响应表现不同

一般建议:**按你要用的工具选对应分组**(Claude Code 选 Claude 分组、Codex 选 GPT 分组、Grok 选 Grok 分组);日常用推荐分组,追求稳定可选更高规格的分组。用着卡顿时可以换个分组/节点再试。

---

## 可以创建多个密钥吗?

可以。在「API 密钥」页面想建几个建几个,用来区分不同项目或工具。**每个密钥独立管理,但共享同一个账户余额。** 想同时用 Claude Code 和 Codex,就分别建两个对应分组的密钥。

---

## 一个密钥能同时用于所有工具吗?

不建议。密钥是和**分组**绑定的,而不同工具走不同分组。最稳妥的做法是:**一个工具一个密钥,各选对应分组**。

---

## Base URL 到底要不要加 `/v1`?

看工具怎么要求:

- **OpenAI 兼容 Base URL**:通常填到 `/v1`,例如 `https://api.clomio.ai/v1`、`https://sub.qazwc.com/v1`。
- **只要求域名/网关地址**、另外有 Path/Endpoint 配置:通常不要加 `/v1`,填 `https://api.clomio.ai`。
- 如果报错路径里出现 `.../v1/v1/...`,就是 `/v1` 写重复了。
- 如果报 `404` 且请求路径没有 `/v1`,通常是少写了 `/v1`。

不确定时,把工具名称和当前 Base URL 截图发工单。

---

## 新手最常见的 5 类错误怎么改?

| 现象/报错 | 多半原因 | 直接改法 |
|------|------|------|
| 请求地址里出现 `/v1/v1` | Base URL 已经写了 `/v1`,工具又自动拼了一次 | OpenAI-compatible 保留一个 `/v1`;不要把 Base URL 填成完整端点 |
| Claude Code 404、认证测试怪异或真实调用失败 | Claude Base URL 写成了 `https://api.clomio.ai/v1` | 改成 `https://api.clomio.ai`,让 Claude 自己拼 `/v1/messages` |
| OpenAI SDK / Codex 404 | Base URL 少了 `/v1` | 改成 `https://api.clomio.ai/v1`;线路域名同理加 `/v1` |
| `model_not_found` / `unsupported model` | 模型名不是控制台开放模型,或 Key 分组不支持该模型 | 先看控制台模型列表或 `GET /v1/models`,按列表里的名字填 |
| Claude Key 调 `/v1/responses` / `/v1/chat/completions` 失败 | Claude/Anthropic 分组主协议是 Messages | Claude Code/Anthropic SDK 用 `/v1/messages`;要调 OpenAI Responses/Chat 就换 OpenAI/Codex 分组 Key |
| Grok Key 调 `/v1/chat/completions` 失败 | Grok 对话走 Responses,不走 Chat Completions | Grok 用 `POST /v1/responses`;不要把 Grok 配成 Chat Completions 客户端 |
| 非 Grok Key 调 videos 失败 | Videos 仅 Grok | 换已开通视频能力的 Grok 分组 Key 和 Grok 视频模型 |

如果已经换过线路,仍然同样失败,说明问题通常不是网络,而是 Key 分组、Base URL、端点或模型名不匹配。

---

## 一个 key 能跨 Claude Code、Codex、Grok 等工具共用吗?

技术上同一个 key 可以被多个客户端拿去请求,但**不推荐**。原因是 key 绑定分组,而分组通常绑定协议和上游能力:

- Claude Code:优先用 Claude 分组,走 `/v1/messages`;
- Codex / OpenAI SDK:用 GPT/OpenAI 分组,走 `/v1/responses` 或 `/v1/chat/completions`;
- Grok:用 Grok 分组;视频生成也用 Grok 视频分组。

最稳妥做法仍是:**一个工具一个 key,各选对应分组**。这样用量、报错和工单也更好定位。

---

## 怎么判断 `No available accounts` 是模型不支持,还是临时没账号?

看报错关键词:

- `The current group does not support the requested model ... Available models: ...`:分组明确不支持,按列表换模型或换分组。
- `model_not_found` / `Model "xxx" is not supported by any configured account in this group`:组里有账号,但没有任何已配置账号支持这个模型,多半是模型名或模型映射问题。
- 只有 `No available accounts` / `Service temporarily unavailable`:更像临时容量、429、账号冷却、并发槽位或上游波动,稍后重试或换分组。
- `No available accounts supporting model: xxx`:介于两者之间,可能是模型支持问题,也可能是支持账号被临时排除。先核对模型名和分组支持列表;持续出现带 request_id 工单。

---

## 控制台里的 AI 聊天、图片、画廊和 Prompt 模板怎么用?

如果你登录后能看到这些入口,可以把它们当成“控制台内置试验场”:

- **AI 聊天**:用来快速验证某个 Key 分组、模型名、余额和权限是否正常。
- **图片**:入口可见且分组已开放时,可先在控制台试图片模型;Images 可用 OpenAI 分组或 Grok 分组。视频能力单独只走 Grok 分组。
- **画廊**:如果入口可见,可查看或管理已生成内容,适合复用提示词和结果。
- **Prompt 模板**:如果入口可见,可从模板改写需求,再复制到 Claude Code、Codex、Grok 或 SDK。

这些是控制台功能入口，不是公开网关 API：终端或 SDK 不能把 `/user/ai/*`、`/user/skills/*` 当成 OpenAI/Claude/Grok 兼容端点调用。不是所有租户都会展示；是否可用以当前页面、站点开关和套餐/权限为准。

---

## 使用记录里的错误详情和 request_id 有什么用?

如果控制台「用量 / 使用记录」里能点开错误详情,优先保存:

- `request_id` 或 `x-request-id`
- HTTP 状态码和错误摘要
- 模型名、端点、Base URL、Key 分组
- 发生时间和是否换过线路

带 `request_id` 工单排查会更快。没有 request_id 时,先到错误请求页按时间、模型、状态码、分类和 Key 过滤,复制错误 `id`、`message`、`error_body`、`upstream_status_code`;仍找不到时,至少提供时间、Key 名称/后几位、模型名、端点和完整响应体。
它不是完整请求归档。用量记录主要证明计费和模型/Key/分组事实；错误详情主要证明失败阶段和上游错误。若只看到 `Recovered upstream error` 且最终请求成功，通常是自动容灾记录，不代表最终失败。


---

## 兑换码、订阅、2FA、邀请返利在哪里?

如果账户页或安全页展示对应入口,按页面说明操作即可:

- **兑换码**:入口可见时输入兑换码,兑换后看余额或套餐是否变化。
- **订阅**:入口可见时按套餐说明开通/续费;生效范围、额度和到期时间以控制台为准。
- **2FA/TOTP**:安全设置入口可见时,用认证器 App 扫码绑定,确认恢复码已保存后再开启。
- **邀请返利**:邀请入口可见时,复制你的邀请链接;返利比例、有效期和结算规则以入口当前说明为准。

如果某个入口不可见,通常表示当前租户、账号权限、套餐或灰度批次暂未开放,不影响按 API 文档正常调用已开放模型。

---

## 工单可以上传什么附件?

如果工单入口支持附件,建议上传和问题直接相关的材料:终端报错截图、curl `-i` 输出、工具配置截图、控制台用量/错误详情截图、订单或支付凭证。注意同时在文字里写清 Base URL、端点、模型名、Key 名称/分组、发生时间、request_id 或错误请求 `id`;附件只作为补充,不要只发图片不写关键信息。

---

## 怎么充值?

登录控制台 → 点「充值 / 现在充值」→ 按页面提示完成支付,余额会自动到账,无需手动兑换。具体起充金额和支付方式以充值页为准。

---

## 服务稳定吗?用着卡顿怎么办?

国内访问卡顿,最先该试的是**换一条网关线路**。Clomio 提供三条线路,共用同一密钥:

- `https://api.clomio.ai` —— 默认直连(国外服务器最佳)
- `https://sub.qazwc.com` —— Cloudflare 优化
- `https://crs.qazwc.com` —— 三网优化(国内通常最稳)

把工具配置里的地址换成更稳的一条即可,详见 [网关线路](#/gateway-lines)。

如果换线路仍不理想,再试**切换分组/节点**:

1. 在控制台「API 密钥」里给密钥切换到另一个可用分组/节点
2. 刷新页面确认生效
3. 回到工具里重新发一条消息验证

> 注意区分三件事:**换线路**改 Base URL(治网络卡顿)、**换分组**在控制台选(改模型与倍率)、**换模型**用 `/model`(改本次对话的模型)。

---

## 登录鉴权会经过 Clomio 吗?

Clomio 网关只负责**转发你的模型请求并计费**。工具本身的安装走 `help.clomio.ai` 镜像,模型调用走 `api.clomio.ai` 网关并用你的 Clomio 密钥鉴权——你**不需要**再登录任何海外账号。

---

## 装好工具后第一次用就报错?

这是最常见的情况,绝大多数是**代理(翻墙)环境**或**命令找不到 / 权限**问题。请直接看 [故障排查](#/troubleshooting),里面按报错类型给了对应解法。

---

## 为什么使用记录里有 `Recovered upstream error`?

这通常表示请求过程中某次上游调用返回了 5xx/429/限速等错误，但网关自动切换或重试后成功了。它和最终成功请求通过同一个 `request_id` / `client_request_id` 关联，方便排障时看到中间发生过什么。

如果最终状态是成功、你也收到了正常回复,一般**不用处理**。只有当同一工具频繁卡顿、费用异常或最终请求失败时,再带 `request_id` 联系支持。

---

## Videos 为什么只能用 Grok?

当前网关把视频端点按分组平台和视频权限控制。非 Grok 分组请求 `/v1/videos`、`/v1/videos/generations` 会返回类似 `Videos API is not supported for this platform`;分组没开视频权限会返回 `Video generation is not enabled for this group`。新接入请使用 `/v1/videos...`,不要使用不带 `/v1` 的 `/videos...`。

所以视频生成请使用**已开通视频的 Grok 分组**。文本、图片、Claude Code 建议分别使用对应分组和独立 key。

---

## 为什么 `GET /v1/responses/{id}` 或 `GET /v1/models/{id}` 会 404?

因为这两个 REST 查询路由当前不存在:

- Responses 多轮续接不是靠 `GET /v1/responses/{id}` 查历史,而是在下一次 `POST /v1/responses` 中传 `previous_response_id`,或交给 Codex/SDK 维护会话。`GET /v1/responses` 只用于 Codex/Responses WebSocket v2 流入口。
- Models 只提供 `GET /v1/models` 列表。要确认某个模型是否可用,请看列表返回值,或对目标端点发一次最小请求。

如果你只是想排查模型不可用,优先看 `The current group does not support...`、`model_not_found`、`No available accounts supporting model...` 这些关键词,见 [故障排查](#/troubleshooting)。

---

## `actual_cost` 和 `cost` / `total_cost` 有什么区别?

简单理解:

- `total_cost` / `cost`:按模型官方基础价格算出的原始成本参考;
- `actual_cost`:实际从余额或套餐里扣除/统计的费用,会应用分组倍率、用户专属倍率、服务档位、图片/视频等计费规则。

所以你看到 `actual_cost` 和 `total_cost` 不一样是正常的。判断实际扣费看 `actual_cost`;想理解模型原始计价参考看 `total_cost`。