# 网关线路

Clomio 网关提供**三条线路**,内容完全一致、共用同一个 API 密钥,区别只在网络优化方向。哪条快、哪条稳,取决于你的网络环境——**选一条体验最好的用即可,随时可换。**

---

## 三条线路

| 线路地址 | 优化方向 | 适合 |
|----------|----------|------|
| `https://api.clomio.ai` | **默认直连** | 国外服务器、或本身能直连国外的网络,延迟最低 |
| `https://sub.qazwc.com` | **Cloudflare 优化** | 走 CF CDN,国内多数家庭宽带较稳 |
| `https://crs.qazwc.com` | **三网优化** | 针对电信 / 联通 / 移动优化,国内访问更快更稳 |

> 三条线路接受相同的密钥、相同的协议。本文档其他页面的配置示例默认用 `api.clomio.ai`,你可以**直接替换成任意一条**。
>
> 替换时只换域名,不要改协议规则:OpenAI-compatible / Codex / Grok / Hermes/OpenClaw OpenAI-compatible用 `线路 + /v1`;Claude Code / Anthropic-compatible 用不带 `/v1` 的线路根地址。

---

## 怎么选

1. 先用默认的 `api.clomio.ai` 试。
2. 如果在国内直连不稳(卡顿、超时、偶发失败),换成 `crs.qazwc.com`(三网优化)通常最稳。
3. 仍不理想,再试 `sub.qazwc.com`(CF 优化)。

哪条延迟低、掉线少,就长期用哪条。不同地区、不同运营商的最优线路可能不同,多试一下即可。

---

## 换线路时 Base URL 怎么写

| 场景 | `api.clomio.ai` | `sub.qazwc.com` | `crs.qazwc.com` |
|------|------|------|------|
| Claude Code / Anthropic-compatible | `https://api.clomio.ai` | `https://sub.qazwc.com` | `https://crs.qazwc.com` |
| OpenAI-compatible / Codex / Grok | `https://api.clomio.ai/v1` | `https://sub.qazwc.com/v1` | `https://crs.qazwc.com/v1` |
| Hermes/OpenClaw Anthropic-compatible | `https://api.clomio.ai` | `https://sub.qazwc.com` | `https://crs.qazwc.com` |
| Hermes/OpenClaw OpenAI-compatible | `https://api.clomio.ai/v1` | `https://sub.qazwc.com/v1` | `https://crs.qazwc.com/v1` |
| Gemini 原生 | `https://api.clomio.ai` + `/v1beta/...` | `https://sub.qazwc.com` + `/v1beta/...` | `https://crs.qazwc.com` + `/v1beta/...` |
| Antigravity | `https://api.clomio.ai` + `/antigravity/...` | `https://sub.qazwc.com` + `/antigravity/...` | `https://crs.qazwc.com` + `/antigravity/...` |

换线路不等于换协议:不要因为换了域名就增删 `/v1`。Key 分组和模型名也不会因为换线路而改变。

线路只影响**域名和网络路径**,不改变 API 前缀:模型网关按协议走 `/v1`、`/v1beta` 或 `/antigravity/...`;控制台网页自己的用户 API 仍是前端访问 `/api/v1/...`。不要把控制台 JWT 接口和模型网关 API Key 接口混在一起。

## 怎么换线路

换线路 = 把工具配置里的**地址(Base URL)**换成另一条,密钥不用动。

**Claude Code** —— 改 `ANTHROPIC_BASE_URL`:

```bash
export ANTHROPIC_BASE_URL="https://crs.qazwc.com"
```

或写进 `~/.claude/settings.json` 的 `env.ANTHROPIC_BASE_URL`。

**Codex** —— 改 `~/.codex/config.toml` 里 provider 的 `base_url`:

```toml
[model_providers.clomio]
base_url = "https://crs.qazwc.com/v1"
```

**Grok / OpenAI-compatible 客户端** —— 把 Base URL 换成对应线路(OpenAI-compatible 接口在末尾加 `/v1`,如 `https://crs.qazwc.com/v1`)。

**Hermes / OpenClaw** —— 看你选择的协议模式:

- OpenAI-compatible / `openai-responses` / `openai-completions`: `https://crs.qazwc.com/v1`
- Anthropic-compatible / `anthropic-messages`: `https://crs.qazwc.com`

改完重开终端(或重启工具)生效。

## curl 快速测线路

只测网络和鉴权可先拉模型列表(OpenAI-compatible,带 `/v1`):

```bash
for base in https://api.clomio.ai https://sub.qazwc.com https://crs.qazwc.com; do
  echo "== $base"
  curl -sS -o /dev/null -w "%{http_code} %{time_connect}s %{time_starttransfer}s\n" \
    "$base/v1/models" \
    -H "Authorization: Bearer 你的密钥"
done
```

同一把 Key 也可以用 `/v1/usage` 快速看网关鉴权、额度和限速状态；这个端点用于自助对账,不会触发模型调用计费：

```bash
curl https://crs.qazwc.com/v1/usage \
  -H "Authorization: Bearer 你的密钥"
```

不用 Key 时,`GET /v1/models` 返回 **401 JSON** 也代表已经打到模型网关,不是线路坏:

```bash
curl -i https://api.clomio.ai/v1/models
curl -i https://sub.qazwc.com/v1/models
curl -i https://crs.qazwc.com/v1/models
```

当前可用的识别方式:

- `api.clomio.ai`:直连网关,响应常见 `server: nginx`。
- `sub.qazwc.com`:Cloudflare 线路,响应常见 `server: cloudflare`、`cf-ray`。
- `crs.qazwc.com`:三网优化线路,以 `GET /v1/models` 的 401/JSON 和 `x-request-id` 判断是否到达网关。

不要用 `HEAD /v1/models` 或 `/nginx-health` 泛化判断线路可用性;不同线路和代理层对 HEAD/健康检查路径的处理可能不同。排障时记录 HTTP 状态码、响应体、`x-request-id` / `x-client-request-id`;Cloudflare 线路再记录 `cf-ray`。

测 Claude/Anthropic 协议时,配置里的 Base URL 虽然不带 `/v1`,curl 仍要请求真实端点 `/v1/messages`:

```bash
curl https://crs.qazwc.com/v1/messages \
  -H "Authorization: Bearer 你的密钥" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4-6","max_tokens":1,"messages":[{"role":"user","content":"ping"}]}'
```

测 Gemini 原生和 Antigravity 时,Base URL 填线路根地址,请求路径自带 `/v1beta` 或 `/antigravity/...`:

```bash
curl https://crs.qazwc.com/v1beta/models \
  -H "Authorization: Bearer 你的密钥"

curl https://crs.qazwc.com/antigravity/v1/models \
  -H "Authorization: Bearer 你的密钥"
```

---

## 和"切换分组"的区别

- **换线路**:解决网络层面的卡顿 / 不稳定,改的是 **Base URL**。
- **换分组**:改变可用模型与计费倍率,在控制台给密钥重新选分组。
- **换模型**:在工具里用 `/model`,改的是这次对话用哪个模型。

三者互不影响。卡顿先换线路;想要更便宜或不同模型才动分组 / `/model`。不要用 Claude 分组 Key 调 OpenAI `/v1/responses`;Claude Code 推荐使用 Claude/Anthropic 分组 Key。OpenAI/Grok 分组在当前分组开放 Messages 兼容能力时也可走兼容桥。这类错误通常表现为 401、404、`model not found` 或“当前平台不支持该端点”。

---

> 线路状态可在控制台 [api.clomio.ai](https://api.clomio.ai) 查看;若某条线路集体异常,换另一条即可。

## 相关文档

- [Base URL 与 /v1 规则](#/base-url-matrix)：确认每类客户端该填根地址还是 `/v1` 地址。
- [Claude Code](#/claude-code)：`ANTHROPIC_BASE_URL` 使用不带 `/v1` 的线路根地址。
- [Codex 配置详解](#/codex-config)：Codex provider 的 `base_url` 使用带 `/v1` 的 OpenAI-compatible 地址。
- [故障排查](#/troubleshooting)：区分线路问题、分组问题、模型问题和上游限速。