# API 总览

WebberAI 是 AI API Gateway，面向不同客户端提供兼容式模型调用入口。一般情况下，优先使用 OpenAI 兼容 API。

## 基础地址

| 协议 | Base URL | 适用场景 |
| --- | --- | --- |
| OpenAI 兼容 | `https://webberai.top/v1` | OpenAI SDK、Cherry Studio、Codex、OpenCode、RikkaHub、多数 IDE 插件 |
| Claude 兼容 | 以 WebberAI 密钥页生成地址为准 | Claude Code 或 Anthropic 协议工具 |
| Gemini 兼容 | 以 WebberAI 密钥页生成地址为准 | Gemini CLI 或 Gemini 协议工具 |

::: warning
Claude 与 Gemini 兼容入口是否可用，取决于当前 API Key 支持的平台类型和 WebberAI 站内生成配置。不要在未确认的情况下把 OpenAI Base URL 强行用于 Claude 或 Gemini 协议。
:::

## 认证方式

OpenAI 兼容接口使用 Bearer Token：

```http
Authorization: Bearer YOUR_WEBBERAI_API_KEY
```

API Key 来自 [API Keys](https://webberai.top/keys) 页面。

## 端点索引

- [OpenAI 兼容 API](/api/openai)：`/v1/models`、`/v1/chat/completions`、`/v1/responses`、图像相关接口。
- [Claude API](/api/claude)：Anthropic / Claude 兼容工具接入说明。
- [Gemini API](/api/gemini)：Gemini 兼容工具接入说明。

## 选择建议

- 你在写 Python、Node.js 或后端服务：选 [OpenAI 兼容 API](/api/openai)。
- 你在用 Cherry Studio、RikkaHub、OpenCode、Codex：选 [OpenAI 兼容 API](/api/openai)。
- 你在用 Claude Code：先看 [Claude Code 使用指南](/docs/agents/claude-code)，优先复制 WebberAI 密钥页配置。
- 你在用 Gemini CLI：先看 [Gemini API](/api/gemini)，优先复制 WebberAI 密钥页配置。

## 测试接口

```bash
curl https://webberai.top/v1/models \
  -H "Authorization: Bearer YOUR_WEBBERAI_API_KEY"
```

如果返回 `INVALID_API_KEY`，说明请求已到达 WebberAI，但密钥无效或不完整。