Integrieren Sie Brainiall in Ihre App in Python oder Node.js
Die API von Brainiall ist OpenAI-kompatibel
Wenn du bereits weißt, wie man Requests an die API von OpenAI macht, weißt du es auch für Brainiall. Es ändern sich nur 2 Dinge:
1. Base URL: https://api.brainiall.com/v1 (statt https://api.openai.com/v1)
2. API Key: Format brnl-... (statt sk-...)
Alles andere ist identisch. Dein bestehender Code funktioniert, wenn du diese beiden Werte austauschst.
Schritt 1: Erstellen Sie Ihren API key
1. Gehen Sie auf https://app.brainiall.com
2. Login mit Google (falls erste Anmeldung)
3. Menü → API Keys → „Neu erstellen"
4. Geben Sie einen beschreibenden Namen ein („meine-app-prod" oder ähnliches)
5. Kopieren Sie den Key — er wird nur einmal angezeigt, bewahren Sie ihn gut auf
Pro für €5,49 hat 1 aktiven Key; Business beinhaltet Credits + mehrere Keys + Rotation.
Schritt 2: Python mit httpx
`python
import httpx
BASE = "https://api.brainiall.com/v1"
KEY = "brnl-d13..." # Ihr Schlüssel
def chat(prompt, model="claude-sonnet-4-6"):
r = httpx.post(
f"{BASE}/chat/completions",
json={
"model": model,
"messages": [{"role": "user", "content": prompt}]
},
headers={"Authorization": f"Bearer {KEY}"},
timeout=60
)
r.raise_for_status()
return r.json()["choices"][0]["message"]["content"]
print(chat("Erkläre TLS in 2 Sätzen."))`
Schritt 3: Python mit dem offiziellen OpenAI SDK
Das OpenAI SDK funktioniert zu 100% — wir unterstützen Streaming, Function Calling, Tool_use, Vision und alle OpenAI-Standards.
Schritt 4: Node.js
`javascript
import OpenAI from 'openai';
const client = new OpenAI({
baseURL: 'https://api.brainiall.com/v1',
apiKey: 'brnl-xxx'
});
const r = await client.chat.completions.create({
model: 'claude-sonnet-4-6',
messages: [{ role: 'user', content: 'Hallo!' }]
});
console.log(r.choices[0].message.content);`
Verfügbare Modelle
Verwenden Sie den Endpoint /v1/models, um in Echtzeit aufzulisten:
`python
r = httpx.get(f"{BASE}/models", headers={"Authorization": f"Bearer {KEY}"})
for m in r.json()["data"]:
print(m["id"])`
Kategorien:
- Text: claude-sonnet-4-6, gpt-5, gemini-3-pro, llama-4-maverick, deepseek-v3, usw.
- Image: gemini-3-flash-image, gpt-5-image, flux-2-klein, seedream-4.5
- Video (separater Endpoint /v1/videos): bytedance/seedance-2.0-fast
- TTS (Endpoint /v1/audio/speech): 54 Stimmen
- STT (Endpoint /v1/audio/transcriptions): Whisper Large v3
Streaming (server-sent events)
Streaming reduziert die wahrgenommene Latenz drastisch — Token erscheinen während der Generierung, anstatt auf die vollständige Antwort zu warten.
Rate limits und bewährte Praktiken
- Free tier API: existiert nicht — API erfordert Pro- oder Business-Plan
- Pro €5,49: beinhaltet Chat + Bild über Portal, API wird nutzungsbasiert abgerechnet
- Business €18: €9/Monat an API-Guthaben bereits enthalten
- Retry: verwende exponentielles Backoff für 429/5xx
- Cache: deterministische Antworten lokal speichern
- Timeout: 60s ist sicher; für lange Aufgaben wie Video, 300s
Häufige Fallstricke
Bearervor dem Key vergessen → 401- Key im Code hardcoden → früher oder später Leak beim git push; verwende env vars
- 429 nicht behandeln → Anwendung stoppt
usagein der Response ignorieren → Überraschung beim Billing- Falsches Modell für einfache Aufgabe verwenden → unnötige 10-fache Kosten
Teste jetzt gleich
Erstellen Sie Ihren Key unter https://app.brainiall.com und führen Sie eines der obigen Beispiele aus. Pro €5,49 ist das Minimum für den Zugang zur API; Business €18 beinhaltet ausreichend Credits für den Einstieg.