New Kimi K2 Thinking & Qwen3-Max are live. Browse models →

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 accountor 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 asmodel. That’s it — you’re calling models from China’s top 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 themodels page for descriptions and capabilities.

Model idDisplay nameContext
deepseek-chatDeepSeek-V3.2128K
deepseek-reasonerDeepSeek-R1128K
qwen3-maxQwen3-Max256K
qwen3-235b-a22bQwen3 235B A22B256K
qwen3-32bQwen3 32B128K
qwen3-coder-plusQwen3 Coder Plus256K
qwen-vl-maxQwen VL Max128K
text-embedding-v4Text Embedding v48K
glm-4.6GLM-4.6200K
glm-4.5-airGLM-4.5 Air128K
glm-4.5-flashGLM-4.5 Flash128K
kimi-k2-0905Kimi K2 (0905)256K
kimi-k2-thinkingKimi K2 Thinking256K
doubao-seed-1-6Doubao Seed 1.6256K
doubao-seed-1-6-flashDoubao Seed 1.6 Flash256K
doubao-seed-1-6-visionDoubao Seed 1.6 Vision128K
MiniMax-M2MiniMax-M2200K
ernie-4.5-turboERNIE 4.5 Turbo128K
ernie-4.5-x1ERNIE 4.5 X1128K
hunyuan-turbosHunyuan TurboS256K
hunyuan-t1Hunyuan T132K
spark-x1Spark X132K
spark-liteSpark Lite32K
step-3Step-364K

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, check the News page for incidents.

Stuck on something?

Check the console for keys, quotas and billing, or email us athello@brushllm.com.

Open the console