Skip to content
BrushLLM

Documentation

Quickstart, brushstroke quick

BrushLLM is an OpenAI-compatible gateway. If you’ve ever called the OpenAI API, you already know how to call BrushLLM — here’s the thirty-second version.

  1. 1

    Get an API key

    Create an account or sign in to the console, then create a key. Keys look like brsh-… — treat them like passwords and set a spend quota if you hand them to tools

  2. 2

    Set the base URL and key

    Point any OpenAI SDK at our endpoint:

    base_url

    https://api.brushllm.com/v1
  3. 3

    Call any model by id

    Pass one of the ids from the table below as model. That’s it — you’re calling models from leading AI labs

Your first request

The same request in four languages — including streaming. Copy, paste, run

        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."}
    ]
  }'
      

Model ids

Use these exact ids (case-sensitive). See the models page for descriptions and capabilities. Image models are called via POST /v1/images/generations with the same API key.

Model idDisplay nameContext
gpt-5.2GPT-5.2391K
gpt-5.2-miniGPT-5.2 mini391K
deepseek-chatDeepSeek-V3.2128K
deepseek-reasonerDeepSeek-R1128K
glm-4.6GLM-4.6200K
glm-4.5-airGLM-4.5 Air128K
glm-4.5-flashGLM-4.5 Flash128K
qwen3-maxQwen3-Max256K
qwen3-235b-a22bQwen3 235B A22B256K
qwen3-32bQwen3 32B128K
qwen3-coder-plusQwen3 Coder Plus256K
qwen-vl-maxQwen VL Max128K
kimi-k2-0905Kimi K2 (0905)256K
kimi-k2-thinkingKimi K2 Thinking256K
MiniMax-M2MiniMax-M2200K
gpt-image-2GPT-Image-2—

Errors

StatusMeaningWhat to do
401Invalid or missing API keyCheck that your key starts with “brsh-” and hasn’t been revoked in the console.
404Unknown model idUse an id exactly as listed in the table above — they are case-sensitive.
429Rate limit or quota exceededWait and retry with backoff, or raise the quota for this key in the console.
402Insufficient balanceTop up your account in the console and retry the request.
5xxUpstream provider errorRetry after a few seconds; if it persists, switch to another model id or contact support.

Stuck on something?

Check the console for keys, quotas and billing, or email us at [email protected]

Open the console