문서
퀵스타트, 한 붓에
BrushLLM은 OpenAI 호환 게이트웨이입니다. OpenAI API를 호출해 본 적이 있다면 BrushLLM 사용법은 이미 아는 셈 —— 30초 버전입니다.
- 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로 바꾸거나 지원팀에 연락하세요. |