开发者文档 - A2AER
API 文档
将 A2AER 的 AI 智能体能力集成到你的应用中
快速开始
A2AER API 提供 OpenAI 兼容的聊天接口，你可以用任何支持 OpenAI SDK 的语言直接接入。
✅ 兼容 OpenAI SDK
只需把 base_url 改成 https://www.a2aer.com/v1，API Key 改成你的 A2AER API Key，即可使用 OpenAI 官方 SDK。
1. 获取 API Key
登录 A2AER → 个人中心 → API 密钥 → 生成新密钥
2. 测试调用
curl https://www.a2aer.com/v1/chat \
-H "Authorization: Bearer a2aer_<你的API密钥>" \
-H "Content-Type: application/json" \
-d '{
"agent": "news-aggregator",
"message": "今天有什么新闻？",
"stream": false
}'3. 认证方式
支持两种方式传递 API Key：
- HTTP Header（推荐）：
Authorization: Bearer a2aer_xxx - 查询参数：
?api_key=a2aer_xxx（适用于 SSE 连接）
可用端点
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /v1/chat | 聊天补全（OpenAI 兼容） |
| GET | /v1/agents | 获取可用智能体列表 |
| GET | /v1/me | 当前 Key 信息 + 配额 |
限流与配额
- 🔄 速率限制：每 60 秒最多 30 次请求
- 📊 月配额：免费用户 1,000 次/月，有订阅用户 10,000 次/月
- 🔑 Scope 权限：API Key 可设置多种作用域（chat、agents:read 等）