# API 接入参数

WebberAI 提供 OpenAI 兼容 API。大多数支持 OpenAI 或 OpenAI Compatible 的客户端，都可以直接接入。

::: tip
更完整的协议说明请查看 [API 总览](/api/)、[OpenAI 兼容 API](/api/openai)、[Claude API](/api/claude) 和 [Gemini API](/api/gemini)。
:::

## 基础信息

| 项目 | 值 |
| --- | --- |
| 主站 | `https://webberai.top` |
| OpenAI 兼容 Base URL | `https://webberai.top/v1` |
| API Key 来源 | [https://webberai.top/keys](https://webberai.top/keys) |
| 模型列表 | [https://webberai.top/models](https://webberai.top/models) |
| 认证方式 | `Authorization: Bearer YOUR_WEBBERAI_API_KEY` |

## 获取模型列表

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

如果返回 `INVALID_API_KEY`，说明密钥无效、复制不完整或已删除。

## Chat Completions 示例

```bash
curl https://webberai.top/v1/chat/completions \
  -H "Authorization: Bearer YOUR_WEBBERAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "请替换为模型广场中的模型 ID",
    "messages": [
      { "role": "user", "content": "用一句话介绍 WebberAI。" }
    ]
  }'
```

## Python 示例

```python
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_WEBBERAI_API_KEY",
    base_url="https://webberai.top/v1",
)

response = client.chat.completions.create(
    model="请替换为模型广场中的模型 ID",
    messages=[
        {"role": "user", "content": "写一个三点式产品介绍。"}
    ],
)

print(response.choices[0].message.content)
```

## 地址填写规则

不同客户端对 Base URL 的处理方式不同：

- 如果客户端要求填写 `API Base URL`，优先填 `https://webberai.top/v1`。
- 如果客户端说明会自动追加 `/v1`，填写 `https://webberai.top`。
- 如果请求报 `404`，先检查是否把地址写成了 `https://webberai.top/v1/v1`。
- 如果请求报 `401` 或 `INVALID_API_KEY`，优先检查 API Key 是否来自当前 WebberAI 账号。

## 以站内配置为准

WebberAI 的 [API Keys](https://webberai.top/keys) 页面会根据密钥平台生成客户端配置示例。若本文档与站内“使用密钥 / Use Key”弹窗存在差异，以站内实时生成的配置为准。