文件
快速上手, 一筆帶過
BrushLLM 是一個 OpenAI 相容閘道。如果你呼叫過 OpenAI API,就已經會用 BrushLLM —— 三十秒版本如下。
- 1
- 2
設定 base URL 與 key
把任意 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 key。
| 模型 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 key 無效或缺失 | 檢查你的 key 是否以 “brsh-” 開頭,且未在控制台中被撤銷。 |
| 404 | 未知模型 id | 使用與上表完全一致的 id —— 區分大小寫。 |
| 429 | 觸發限流或超出限額 | 等待後帶退避重試,或在控制台調高該 key 的限額。 |
| 402 | 餘額不足 | 在控制台為帳戶儲值後重試請求。 |
| 5xx | 上游供應商錯誤 | 幾秒後重試;若持續出現,換一個模型 id 或聯絡支援。 |