# Antigravity 接入

Antigravity 专用入口用于 Antigravity 客户端或兼容工具。它和普通 Claude/OpenAI/Gemini 分组分开调度,路由会强制使用 Antigravity 账户,不会和常规 Claude、OpenAI、Grok 账户混在一起。

| 项 | 值 |
|---|---|
| Base URL | `https://api.clomio.ai`(线路可换 `https://sub.qazwc.com` / `https://crs.qazwc.com`) |
| 路径前缀 | `/antigravity/...` |
| Key 分组 | Antigravity 分组 |
| 两种形态 | Anthropic Messages 形态 `/antigravity/v1/...`;Gemini 原生形态 `/antigravity/v1beta/...` |
| 外部参考 | [Antigravity Agent](https://ai.google.dev/gemini-api/docs/antigravity-agent)、[Google Antigravity docs](https://antigravity.google/docs/home)、[Antigravity models](https://antigravity.google/docs/models) |

> 不要把 Base URL 写成 `https://api.clomio.ai/v1`。Antigravity 路径本身已经带 `/antigravity/v1...` 或 `/antigravity/v1beta...`。

---

## 端点

| 方法 | 路径 | 形态 | 用途 |
|---|---|---|---|
| `GET` | `/antigravity/models` | 专用列表 | Antigravity 模型列表别名 |
| `POST` | `/antigravity/v1/messages` | Anthropic Messages | 对话/Agent 消息 |
| `POST` | `/antigravity/v1/messages/count_tokens` | Anthropic Messages | token 计数 |
| `GET` | `/antigravity/v1/models` | Anthropic 风格 | 模型列表 |
| `GET` | `/antigravity/v1/usage` | 专用 | 当前 Key 用量/额度 |
| `GET` | `/antigravity/v1beta/models` | Gemini 原生 | Gemini 风格模型列表 |
| `GET` | `/antigravity/v1beta/models/{model}` | Gemini 原生 | 单模型元数据 |
| `POST` | `/antigravity/v1beta/models/{model}:generateContent` | Gemini 原生 | 非流式生成 |
| `POST` | `/antigravity/v1beta/models/{model}:streamGenerateContent?alt=sse` | Gemini 原生 | SSE 流式生成 |

---

## Claude / Anthropic Messages 形态

适合按 Anthropic Messages 兼容协议工作的客户端。Base URL 仍是根地址,请求完整路径里带 `/antigravity/v1/messages`:

```bash
curl https://api.clomio.ai/antigravity/v1/messages \
  -H "Authorization: Bearer 你的Antigravity分组密钥" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 512,
    "messages": [
      { "role": "user", "content": "你好,请用一句话介绍 Antigravity 入口" }
    ]
  }'
```

计数:

```bash
curl https://api.clomio.ai/antigravity/v1/messages/count_tokens \
  -H "Authorization: Bearer 你的Antigravity分组密钥" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{ "role": "user", "content": "ping" }]
  }'
```

---

## Gemini 原生形态

适合 Antigravity 侧以 Gemini `/v1beta/models...` 形状调用的工具。鉴权可用 `Authorization: Bearer` 或 `x-goog-api-key`:

```bash
curl https://api.clomio.ai/antigravity/v1beta/models/gemini-2.5-pro:generateContent \
  -H "Authorization: Bearer 你的Antigravity分组密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [{ "text": "ping" }]
      }
    ]
  }'
```

流式:

```bash
curl 'https://api.clomio.ai/antigravity/v1beta/models/gemini-2.5-pro:streamGenerateContent?alt=sse' \
  -H "x-goog-api-key: 你的Antigravity分组密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{ "role": "user", "parts": [{ "text": "用一句话回答" }] }]
  }'
```

---

## 和普通 Gemini / Claude / OpenAI 的区别

| 场景 | Base URL | 典型路径 | 分组 |
|---|---|---|---|
| Claude Code / Anthropic SDK | `https://api.clomio.ai` | `/v1/messages` | Claude/Anthropic 分组 |
| Gemini 原生兼容 | `https://api.clomio.ai` | `/v1beta/models/{model}:generateContent` | Gemini 分组 |
| Antigravity 专用 | `https://api.clomio.ai` | `/antigravity/v1/messages` 或 `/antigravity/v1beta/models...` | Antigravity 分组 |
| OpenAI/Codex/Grok | `https://api.clomio.ai/v1` | `/v1/responses`、`/v1/chat/completions`、`/v1/images/*` | OpenAI 或 Grok 分组 |

Antigravity 专用路径会强制 Antigravity 平台。即使请求体模型名看起来像 Claude 或 Gemini,也不会走普通 Claude/Gemini 分组。

Antigravity 目前没有 direct `/antigravity/v1/responses`、`/antigravity/v1/chat/completions`、`/antigravity/v1/embeddings`、`/antigravity/v1/images/*`、`/antigravity/v1/videos/*` 或 `/antigravity/v1/web_search`。如果工具只能发 OpenAI-compatible Responses/Chat/Images,不要套 Antigravity 前缀,请改用普通 `/v1/...` 并绑定对应 OpenAI/Grok 分组 Key;如果是 Videos 或 Web Search,只能绑定 Grok 分组 Key。

---

## 常见错误

| 现象 / 错误 | 原因 | 处理 |
|---|---|---|
| 404 或路径重复 `/v1` | Base URL 写成 `.../v1`,客户端又拼 `/antigravity/v1...` | Base URL 改成 `https://api.clomio.ai` |
| Anthropic 形态 401/403 | Key 不是 Antigravity 分组,或账号/订阅/余额不可用 | 换 Antigravity 分组 Key;检查订阅和余额 |
| Gemini 形态返回 Google 风格 `UNAUTHENTICATED` | 缺 Key、Key 错误、用了废弃 query `api_key` | 使用 `Authorization: Bearer` 或 `x-goog-api-key`;不要用 `api_key` query |
| `No active subscription found for this group` | 该分组需要有效套餐 | 开通或续订对应 Antigravity 分组 |
| `Insufficient account balance` | 余额不足 | 充值或换有额度的 Key |
| `Missing model in URL` / `Unsupported action` | `/antigravity/v1beta/models...` 路径拼错 | 使用 `/antigravity/v1beta/models/{model}:generateContent` |

---

## 排障信息

提交工单时请带:

- 完整 Base URL 与实际请求路径。
- Key 名称和分组名,不要发送完整密钥。
- 使用的是 `/antigravity/v1/messages` 还是 `/antigravity/v1beta/models...`。
- HTTP 状态码、响应体、`x-request-id` 或控制台用量记录。

Antigravity 与 Gemini/Claude 的模型可见性可能不同。以 Antigravity 分组的控制台模型列表、`/antigravity/models` 或对应模型列表端点为准。

## 相关文档

- [Gemini 原生兼容](#/api-gemini)：普通 Gemini 分组的 `/v1beta/models...` 调用方式。
- [创建 API 密钥](#/api-key)：确认 Key 绑定的是 Antigravity 分组还是普通 Gemini/Claude/OpenAI/Grok 分组。
- [Base URL 与 /v1 规则](#/base-url-matrix)：不同协议的根地址是否带 `/v1`。
- [故障排查](#/troubleshooting)：按错误码、端点和分组快速定位。