Developer docs

Build on Beeper.

An OpenAI-compatible API for private, uncensored inference. If your code talks to OpenAI, it talks to Beeper.

Base URL

https://api.beeper.ai/v1

Auth

Bearer sk-beeper-…

Format

OpenAI Chat Completions

Quickstart

1. Buy credits and copy your key. 2. Set BEEPER_KEY. 3. Point your SDK at the base URL.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.beeper.ai/v1",
    api_key=os.environ["BEEPER_KEY"],
)

res = client.chat.completions.create(
    model="beeper/dolphin-mistral-24b",
    messages=[{"role": "user", "content": "Ask anything."}],
)
print(res.choices[0].message.content)

Authentication

Send your key in the Authorization header. Keys are shown once — we only store a hash. Rotate them any time from Account.

Authorization: Bearer sk-beeper-XXXXXXXXXXXXXXXX

Chat completions

POST /v1/chat/completions — same parameters as OpenAI: model, messages, temperature, max_tokens, tools, response_format.

{
  "id": "chatcmpl-9x2…",
  "model": "beeper/hermes-4-405b",
  "upstream_model": "NousResearch/Hermes-4-405B",
  "choices": [{ "message": { "role": "assistant", "content": "…" } }],
  "usage": { "prompt_tokens": 18, "completion_tokens": 212, "cost_usd": 0.00032 }
}

Every response reports the exact upstream_model and the discounted cost_usd.

Streaming

Set "stream": true to receive server-sent events. Gateway overhead is under 40 ms p50.

curl https://api.beeper.ai/v1/chat/completions -N \
  -H "Authorization: Bearer $BEEPER_KEY" -H "Content-Type: application/json" \
  -d '{"model":"beeper/dolphin-mistral-24b","stream":true,
       "messages":[{"role":"user","content":"Tell me a dark story."}]}'

Images

POST /v1/images/generations with an unfiltered model such as beeper/flux-dev-uncensored.

{ "model": "beeper/flux-dev-uncensored", "prompt": "noir city at 3am, rain, neon", "size": "1024x1024" }

List models

GET /v1/models returns every model with live list price and your current discounted price. Filter with ?uncensored=true.

MCP & agents

Use Beeper as the model provider in any agent that supports OpenAI-compatible endpoints — Claude Code proxies, Cursor, Cline, OpenWebUI, SillyTavern, LiteLLM.

# LiteLLM / OpenWebUI / Cline
OPENAI_API_BASE=https://api.beeper.ai/v1
OPENAI_API_KEY=$BEEPER_KEY
MODEL=beeper/hermes-4-405b

Rate limits

Default 600 requests/min and 2M tokens/min per key. Limits rise automatically with lifetime spend. Headers: x-ratelimit-remaining, retry-after.

Errors

400invalid_requestMalformed body or unknown parameter.
401invalid_keyMissing, revoked or mistyped API key.
402insufficient_creditBalance too low. Top up and retry.
404model_not_foundModel ID doesn’t exist. Check /v1/models.
429rate_limitedToo many requests. Respect Retry-After.
502upstream_errorProvider failed. Safe to retry with backoff; you are not billed.