Schnellstart
Vom leeren Projekt zur ersten BLUN API-Antwort in unter einer Minute. Sprache waehlen, einfuegen, starten.
API-Key erstellen
Open Console → API Keys, click Mint key, copy the secret. It starts with blun_sk_ and only shows once.
Noch kein Konto? Kostenlos starten. Fuer den Einstieg ist keine Karte noetig.
Umgebungsvariable setzen
# macOS / Linux
export BLUN_API_KEY=blun_sk_…
# Windows (PowerShell)
$env:BLUN_API_KEY = "blun_sk_…"
Ersten Request senden
Waehle deine Sprache. Derselbe Request funktioniert fuer die BLUN-Modelle; du wechselst nur den "model"-Wert.
# Stream a chat completion against Queen (default workhorse) curl https://api.blun.ai/v1/chat/completions \ -H "Authorization: Bearer $BLUN_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "queen", "stream": true, "messages": [ {"role":"user","content":"Sag Hej auf Schwedisch."} ] }'
// npm i @blun/sdk import { Blun } from "@blun/sdk"; const blun = new Blun({ apiKey: process.env.BLUN_API_KEY }); const stream = await blun.chat.completions.create({ model: "queen", stream: true, messages: [{ role: "user", content: "Sag Hej auf Schwedisch." }], }); for await (const chunk of stream) { process.stdout.write(chunk.choices[0].delta.content ?? ""); }
# pip install blun from blun import Blun import os client = Blun(api_key=os.environ["BLUN_API_KEY"]) stream = client.chat.completions.create( model="queen", stream=True, messages=[{"role":"user", "content":"Sag Hej auf Schwedisch."}], ) for chunk in stream: print(chunk.choices[0].delta.content or "", end="", flush=True)
// go get github.com/blun-ai/blun-go package main import ( "context"; "fmt"; "os" blun "github.com/blun-ai/blun-go" ) func main() { c := blun.New(os.Getenv("BLUN_API_KEY")) stream, _ := c.Chat.Stream(context.Background(), blun.ChatRequest{ Model: "queen", Messages: []blun.Msg{{Role:"user", Content:"Sag Hej auf Schwedisch."}}, }) for chunk := range stream { fmt.Print(chunk.Delta) } }
Du solltest sehen, wie Tokens direkt zurueckgestreamt werden: Hej, ! und so weiter.
Was gerade passiert ist
Du hast POST /v1/chat/completions mit Bearer-Token-Auth aufgerufen. Das Modell (queen) verarbeitet die Nachricht und der Server streamt die Antwort per Server-Sent Events zurueck.
Naechste Schritte
- Authentifizierung — Scopes, Rotation, Widerruf und sichere Nutzung.
- Chat completions API — every parameter, every response field.
- Modell waehlen — wann King, Queen oder Prince passt.
- Bestehende API anbinden — Endpoint, Auth und Antwortformat sauber umstellen.
- Voice (STT + TTS) — gleiches Muster, Audio rein und raus.
- Imagine (Bilder) — Text-zu-Bild mit Stilvorgaben.
Fehler beheben
401 Authentifizierung noetig — pruefe den Bearer-Header, keine Leerzeichen vor oder nach dem Key und keine extra Anfuehrungszeichen.
429 Limit erreicht — warte kurz und versuche es erneut oder nutze einen passenden Plan.
500 / Verbindung bricht im Stream ab — setze einen sinnvollen Timeout und wiederhole den Request kontrolliert.
