从控制台复制模型 ID,然后发送第一条请求。
Bear API 当前仅供已有邀请账户使用,新邀请与付费入口暂停;API 仅开放 POST /v1/chat/completions。现有用户登录控制台后可查看具体模型 ID 和客户价格。
https://bearapi.org/v1/chat/completionscurl https://bearapi.org/v1/chat/completions \
-H "Authorization: Bearer $BEAR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_MODEL_ID",
"messages": [{"role": "user", "content": "回复 OK。"}],
"max_tokens": 256
}'鉴权与模型 ID
把 Bear API 密钥放在标准 Bearer 请求头中。不要在浏览器前端、公开仓库或日志中保存密钥。精确模型 ID 不在未登录页面公布,请从控制台复制,避免使用过期名称。
| 接口 | POST /v1/chat/completions |
|---|---|
| 鉴权 | Authorization: Bearer $BEAR_API_KEY |
| 内容类型 | application/json |
| 模型字段 | YOUR_MODEL_ID(登录控制台后获取) |
JavaScript
const response = await fetch("https://bearapi.org/v1/chat/completions", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.BEAR_API_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "YOUR_MODEL_ID",
messages: [{ role: "user", content: "总结这段纯文本。" }],
max_tokens: 512
})
});
if (!response.ok) throw new Error(`Bear API: ${response.status}`);
const data = await response.json();Python
import os
import requests
response = requests.post(
"https://bearapi.org/v1/chat/completions",
headers={"Authorization": f"Bearer {os.environ['BEAR_API_KEY']}"},
json={
"model": "YOUR_MODEL_ID",
"messages": [{"role": "user", "content": "回复 OK。"}],
"max_tokens": 256,
},
timeout=60,
)
response.raise_for_status()
print(response.json())流式输出
同一接口支持服务端事件流。客户端需要逐行读取响应,并正确处理断开、超时和非成功状态。
{
"model": "YOUR_MODEL_ID",
"stream": true,
"messages": [{"role": "user", "content": "写一段简洁说明。"}],
"max_tokens": 512
}已执行的限制
- 仅支持纯文本 Chat Completions,请求体最大 256 KiB。
- 必须设置
max_tokens或max_completion_tokens,范围为 16–4096。 - 每个密钥最多 4 个并发请求;超过时应退避重试。
- 不支持工具调用,不支持联网搜索,不支持多模态输入,不支持 Anthropic Messages API。
- 当前不提供 SLA;上线前请自行评估可用性与降级方案。
错误处理
客户端应按 HTTP 状态码和响应中的请求标识记录错误。401 通常表示密钥无效,413 表示请求体过大,429 表示并发或速率限制。不要无限重试;仅对暂时性错误使用带抖动的指数退避。