文档
快速上手, 一笔带过
BrushLLM 是 OpenAI 兼容网关。如果你调用过 OpenAI API,就已经会调用 BrushLLM —— 这是三十秒版本。
- 1
- 2
设置 base URL 与密钥
把任意 OpenAI SDK 指向我们的端点:
base_url
https://api.brushllm.com/v1 - 3
按 id 调用任意模型
把下表中的任一 id 作为
model传入。就这样 —— 你已经在调用顶尖实验室的模型了
你的第一次请求
同一个请求,四种语言 —— 含流式输出。复制、粘贴、运行
curl https://api.brushllm.com/v1/chat/completions \
-H "Authorization: Bearer $BRUSH_LLM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-chat",
"messages": [
{"role": "user", "content": "Say hello in three languages."}
]
}'
模型 id
请使用这些精确 id(区分大小写)。描述与能力见模型页面。图像模型通过POST /v1/images/generations调用,使用同一把 API 密钥。
| 模型 id | 显示名称 | 上下文 |
|---|---|---|
gpt-5.2 | GPT-5.2 | 391K |
gpt-5.2-mini | GPT-5.2 mini | 391K |
deepseek-chat | DeepSeek-V3.2 | 128K |
deepseek-reasoner | DeepSeek-R1 | 128K |
glm-4.6 | GLM-4.6 | 200K |
glm-4.5-air | GLM-4.5 Air | 128K |
glm-4.5-flash | GLM-4.5 Flash | 128K |
qwen3-max | Qwen3-Max | 256K |
qwen3-235b-a22b | Qwen3 235B A22B | 256K |
qwen3-32b | Qwen3 32B | 128K |
qwen3-coder-plus | Qwen3 Coder Plus | 256K |
qwen-vl-max | Qwen VL Max | 128K |
kimi-k2-0905 | Kimi K2 (0905) | 256K |
kimi-k2-thinking | Kimi K2 Thinking | 256K |
MiniMax-M2 | MiniMax-M2 | 200K |
gpt-image-2 | GPT-Image-2 | — |
错误码
| 状态码 | 含义 | 处理方法 |
|---|---|---|
| 401 | API 密钥无效或缺失 | 检查密钥以 “brsh-” 开头,且未在控制台中被吊销。 |
| 404 | 未知模型 id | 使用上表中列出的精确 id —— 区分大小写。 |
| 429 | 速率限制或配额超限 | 等待并退避重试,或在控制台中调高该密钥的限额。 |
| 402 | 余额不足 | 在控制台中充值后重试请求。 |
| 5xx | 上游供应商错误 | 几秒后重试;若持续出现,切换到其他模型 id 或联系支持。 |