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://usebeeper.io/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://usebeeper.io/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-XXXXXXXXXXXXXXXXChat completions
POST /v1/chat/completions takes the 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, "total_tokens": 230, "cost_usd": 0.000654 }
}Every response reports the exact upstream_model and the cost_usd.
Streaming
Set "stream": true to receive server-sent events. Gateway overhead is under 40 ms p50.
curl https://usebeeper.io/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 image model such as beeper/lustify-sdxl. Sizes: square, portrait, landscape; up to 4 images per request, billed per image returned.
curl https://usebeeper.io/v1/images/generations \
-H "Authorization: Bearer $BEEPER_KEY" -H "Content-Type: application/json" \
-d '{"model":"beeper/chroma","prompt":"noir city at 3am, rain, neon","size":"portrait","n":1}'
# → { "data": [{ "b64_json": "…" }], "cost_usd": 0.012 }Prompts involving minors are refused for every model.
List models
GET /v1/models returns every model with its price per 1M tokens. 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://usebeeper.io/v1
OPENAI_API_KEY=$BEEPER_KEY
MODEL=beeper/hermes-4-405bRate limits
max_tokens is capped to what your balance can pay for. Requests are rejected with 402 when the balance runs out.
Errors
| 400 | invalid_requestMalformed body or unknown parameter. | Malformed body or unknown parameter. |
| 401 | invalid_keyMissing, revoked or mistyped API key. | Missing, revoked or mistyped API key. |
| 402 | insufficient_creditBalance too low. Top up and retry. | Balance too low. Top up and retry. |
| 404 | model_not_foundModel ID doesn’t exist. Check /v1/models. | Model ID doesn’t exist. Check /v1/models. |
| 429 | rate_limitedToo many requests. Respect Retry-After. | Too many requests. Respect Retry-After. |
| 502 | upstream_errorProvider failed. Safe to retry with backoff; you are not billed. | Provider failed. Safe to retry with backoff; you are not billed. |