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：

Authorization: Bearer YOUR_WEBBERAI_API_KEY

API Key 来自 API Keys 页面。

端点索引

• OpenAI 兼容 API：/v1/models、/v1/chat/completions、/v1/responses、图像相关接口。
• Claude API：Anthropic / Claude 兼容工具接入说明。
• Gemini API：Gemini 兼容工具接入说明。

选择建议

• 你在写 Python、Node.js 或后端服务：选 OpenAI 兼容 API。
• 你在用 Cherry Studio、RikkaHub、OpenCode、Codex：选 OpenAI 兼容 API。
• 你在用 Claude Code：先看 Claude Code 使用指南，优先复制 WebberAI 密钥页配置。
• 你在用 Gemini CLI：先看 Gemini API，优先复制 WebberAI 密钥页配置。

测试接口

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

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