BLUN API sauber starten

Ein Konto, ein API-Key und ein klares Token-System. BLUN verbindet Modelle, Builder und Plattform-Funktionen — Text, Voice, Bilder, Agents und MCP — über eine stabile REST API. EU-gehostet, klar abrechenbar, ohne Tool-Wirrwarr.

Schnellstart →

Erster Request in 60 Sekunden — curl, Node oder Python.

5 min

API-Referenz →

Jeder Endpunkt, jeder Parameter und jedes Antwortformat.

reference

Modell-Aperçu →

King, Queen, Prince, Voice, Imagine — das passende Modell wählen.

Modelle + Plattform

Dein erster Request

The API is a clean REST endpoint. POST a prompt, get a response — JSON in, JSON out, optional streaming.

# env
export BLUN_API_KEY=blun_sk_...

# erster Request
curl https://api.blun.ai/v1/chat/completions \
  -H "Authorization: Bearer $BLUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "queen",
    "messages": [
      {"role":"user","content":"Hello, BLUN."}
    ]
  }'

Du bekommst eine gestreamte oder gepufferte Antwort in sauberem JSON. Details zu SSE stehen unter Streaming.

Heads up Free tier ships with €5 in credit. No card required to start.

Modell wählen

Die BLUN-Modelle teilen sich einen Endpoint. Du wechselst sie über den "model"-Wert.

ModellGut fürKontextPreis reinPreis rausLatenz p50
kingReasoning, long-doc, agents200k€3 / 1M€12 / 1M180 ms
queenStandard für Chat, Routing und Tools64k0,50 EUR / 1M2 EUR / 1M90 ms
princeKlassifizieren und Extrahieren16k0,05 EUR / 1M0,20 EUR / 1M35 ms
voiceSTT + TTS in einem StreamRealtime6 EUR / h—120 ms
imagineSDXL Turbo images——€0.008 / img1.1 s
agentsOrchestration runtime—€0.04 / step——
mcpTool-Hub—enthalten——

Authentifizierung

All API calls require a bearer token in the Authorization header. Keys are minted in the Console — you see the secret exactly once, after that only a masked preview.

Authorization: Bearer blun_sk_...

Keys können auf bestimmte Bereiche begrenzt werden (chat, images, voice, agents). Du kannst sie jederzeit rotieren oder widerrufen. Details stehen unter Authentifizierung.

Endpunkte auf einen Blick

MethodeEndpunktZweck
POST/v1/chat/completionsText erzeugen, gestreamt oder gepuffert
POST/v1/images/generations (noch nicht verfuegbar)Bilder über Imagine erzeugen
POST/v1/audio/speech (noch nicht verfuegbar)Text zu Sprache
POST/v1/audio/transcriptions (noch nicht verfuegbar)Sprache zu Text
POST/v1/embeddings (noch nicht verfuegbar)Embeddings vector
POST/v1/keys (noch nicht verfuegbar)Mint a new API key
GET/v1/keys (noch nicht verfuegbar)Keys anzeigen
DELETE/v1/keys/{id} (noch nicht verfuegbar)Key widerrufen
GET/v1/usage (noch nicht verfuegbar)Nutzung und Zeiträume anzeigen

SDKs

SDKs kapseln die REST API mit Streaming-Helfern, Tool-Nutzung und typisierten Antworten.

Node / TS

npm i @blun/sdk

Python

pip install blun

Go

go get github.com/blun-ai/blun-go

Standard REST

Normale HTTPS-POST-Endpunkte. JSON-Request, JSON-Antwort, Streaming über SSE. Funktioniert mit jedem HTTP-Client und jeder Sprache.

// Beispiel
baseURL: "https://api.blun.ai/v1"
model:   "king"

// Dasselbe Schema für andere Modelle
baseURL: "https://api.blun.ai/v1"
model:   "king"

Nächste Schritte

Schnellstart

Mit Copy/Paste zur ersten Antwort.

Streaming

Antworten tokenweise über SSE ausgeben.

Tool-Nutzung

Gib dem Modell Werkzeuge und klare Grenzen.

Agents

Mehrschrittige Abläufe mit Tools.

Fehler

Was 429, 502 oder 503 bedeutet und was zu tun ist.
Etwas stimmt nicht? Kontakt aufnehmen.
War das hilfreich?
Nicht oeffentlich verfuegbar

Diese Endpunkte sind implementiert, aber ueber api.blun.ai aktuell nicht erreichbar:

  • POST /v1/embeddings
  • POST /v1/images/generations
  • POST /v1/audio/speech
  • POST /v1/audio/transcriptions
  • GET/POST /v1/keys
  • GET /v1/usage