Documentação
Início rápido, num traço
O BrushLLM é um gateway compatível com OpenAI. Se você já chamou a API da OpenAI, já sabe chamar o BrushLLM —— aqui vai a versão de trinta segundos.
- 1
Obtenha uma chave de API
Crie uma conta ou entre no console e crie uma chave. Chaves parecem
brsh-…—— trate-as como senhas e defina uma cota de gasto se entregá-las a ferramentas - 2
Defina a base URL e a chave
Aponte qualquer SDK OpenAI para nosso endpoint:
base_url
https://api.brushllm.com/v1 - 3
Chame qualquer modelo pelo id
Passe um dos ids da tabela abaixo como
model. Só isso —— você já está chamando modelos dos principais laboratórios de IA
Sua primeira requisição
A mesma requisição em quatro linguagens —— incluindo streaming. Copie, cole, execute
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."}
]
}'
Ids de modelos
Use exatamente estes ids (diferenciam maiúsculas). Descrições e capacidades na página de modelos. Modelos de imagem são chamados via POST /v1/images/generations com a mesma chave de API.
| Id do modelo | Nome exibido | Contexto |
|---|---|---|
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 | — |
Erros
| Status | Significado | O que fazer |
|---|---|---|
| 401 | Chave de API inválida ou ausente | Verifique se sua chave começa com “brsh-” e não foi revogada no console. |
| 404 | Id de modelo desconhecido | Use um id exatamente como listado na tabela acima —— eles diferenciam maiúsculas. |
| 429 | Limite de requisições ou cota excedida | Aguarde e tente novamente com backoff, ou aumente a cota desta chave no console. |
| 402 | Saldo insuficiente | Recarregue sua conta no console e repita a requisição. |
| 5xx | Erro do provedor upstream | Tente novamente após alguns segundos; se persistir, mude para outro id de modelo ou contate o suporte. |
Travou em algo?
Consulte o console para chaves, cotas e cobrança, ou escreva para [email protected]
Abrir o console