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 — ueber eine stabile REST API. EU-gehostet, klar abrechenbar, ohne Tool-Wirrwarr.
Schnellstart →
Erster Request in 60 Sekunden — curl, Node oder Python.
API-Referenz →
Jeder Endpunkt, jeder Parameter und jedes Antwortformat.
Modell-Übersicht →
King, Queen, Prince, Voice, Imagine — das passende Modell waehlen.
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.
Modell waehlen
Die BLUN-Modelle teilen sich einen Endpoint. Du wechselst sie ueber den "model"-Wert.
| Modell | Gut fuer | Kontext | Preis rein | Preis raus | Latenz p50 |
|---|---|---|---|---|---|
| king | Reasoning, long-doc, agents | 200k | €3 / 1M | €12 / 1M | 180 ms |
| queen | Standard fuer Chat, Routing und Tools | 64k | 0,50 EUR / 1M | 2 EUR / 1M | 90 ms |
| prince | Klassifizieren und Extrahieren | 16k | 0,05 EUR / 1M | 0,20 EUR / 1M | 35 ms |
| voice | STT + TTS in einem Stream | Realtime | 6 EUR / h | — | 120 ms |
| imagine | SDXL Turbo images | — | — | €0.008 / img | 1.1 s |
| agents | Orchestration runtime | — | €0.04 / step | — | — |
| mcp | Tool-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 koennen auf bestimmte Bereiche begrenzt werden (chat, images, voice, agents). Du kannst sie jederzeit rotieren oder widerrufen. Details stehen unter Authentifizierung.
Endpunkte auf einen Blick
| Methode | Endpunkt | Zweck |
|---|---|---|
| POST | /v1/chat/completions | Text erzeugen, gestreamt oder gepuffert |
| POST | /v1/images/generate | Bilder ueber Imagine erzeugen |
| POST | /v1/voice/synthesize | Text zu Sprache |
| POST | /v1/voice/transcribe | Sprache zu Text |
| POST | /v1/embeddings | Embeddings vector |
| POST | /v1/keys | Mint a new API key |
| GET | /v1/keys | Keys anzeigen |
| DELETE | /v1/keys/{id} | Key widerrufen |
| GET | /v1/usage | Nutzung und Zeitraeume anzeigen |
SDKs
SDKs kapseln die REST API mit Streaming-Helfern, Tool-Nutzung und typisierten Antworten.
Standard REST
Normale HTTPS-POST-Endpunkte. JSON-Request, JSON-Antwort, Streaming ueber SSE. Funktioniert mit jedem HTTP-Client und jeder Sprache.
// Beispiel
baseURL: "https://api.blun.ai/v1"
model: "king"
// Dasselbe Schema fuer andere Modelle
baseURL: "https://api.blun.ai/v1"
model: "king"
Naechste Schritte
Schnellstart
Mit Copy/Paste zur ersten Antwort.
Streaming
Antworten tokenweise ueber SSE ausgeben.
Tool-Nutzung
Gib dem Modell Werkzeuge und klare Grenzen.
Agents
Mehrschrittige Ablaeufe mit Tools.
Fehler
Was 429, 502 oder 503 bedeutet und was zu tun ist.
