API-Dokumentation
Basis-URL https://platform.aim2balance.ai/api/a2b/v1
Authentifizierung und Schlüssel
Sende deinen Schlüssel als Bearer-Token im Header Authorization. Schlüssel erstellst du unter Einstellungen › API-Dashboard. Bewahre sie in einer Umgebungsvariable auf, niemals im clientseitigen Code.
Authorization: Bearer $A2B_API_KEYCodebeispiele
Dieselbe Anfrage in curl, Python und JavaScript. Jedes OpenAI-SDK funktioniert: Ändere nur die Basis-URL und den Schlüssel.
curl https://platform.aim2balance.ai/api/a2b/v1/chat/completions \
-H "Authorization: Bearer $A2B_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "a2b-core",
"messages": [
{ "role": "user", "content": "Explain tidal energy in two sentences." }
]
}'import os
from openai import OpenAI
client = OpenAI(
base_url="https://platform.aim2balance.ai/api/a2b/v1",
api_key=os.environ["A2B_API_KEY"],
)
reply = client.chat.completions.create(
model="a2b-core",
messages=[{ "role": "user", "content": "Explain tidal energy in two sentences." }],
)
print(reply.choices[0].message.content)import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://platform.aim2balance.ai/api/a2b/v1",
apiKey: process.env.A2B_API_KEY,
});
const reply = await client.chat.completions.create({
model: "a2b-core",
messages: [{ role: "user", content: "Explain tidal energy in two sentences." }],
});
console.log(reply.choices[0].message.content);Modelle
Zwei Router, a2b-core und a2b-boost (128k Kontext), wählen für jeden Schritt ein Modell. a2b-code ist auf Coding-Agents abgestimmt (1M Kontext). Du kannst auch einzelne Modelle wie Kimi K3, GLM 5.3, MiniMax M3, DeepSeek V4 Flash, Qwen 3.8 Max oder Mistral Medium 3.5 direkt aufrufen. Kontextgrößen und Preise findest du in der Preisliste.
Anfrageparameter
Chat Completions folgen dem OpenAI-Format: Wähle ein model, sende messages und setze die üblichen Optionen. Die vollständige Parameterliste steht in der Referenz.
Rate- und Parallelitätslimits
Standardmäßig kann jeder Schlüssel 120 Anfragen pro Minute stellen und 8 Anfragen gleichzeitig ausführen.
| Limit | Standard, pro Schlüssel |
|---|---|
| Anfragen | 120 pro Minute |
| Gleichzeitige Anfragen | 8 |
Preise und Kosten
Du zahlst pro Token aus einem vorausbezahlten Guthaben in Euro: den Listenpreis des Modells, plus 10 % Plattformgebühr, plus 2,5 % für die Renaturierung von Ökosystemen, plus 3 % Wechselkursaufschlag, nur bei Modellen mit USD-Preisen. Eine Anfrage, die dein Guthaben nicht deckt, wird abgelehnt, bevor sie läuft. Details auf der Preisseite.
In der vollständigen Referenz öffnenAPI-Schlüssel
Gib jedem Schlüssel ein Ausgabenlimit, eine Warnung, eine Obergrenze für Max Tokens und eine Liste erlaubter Modelle. Organisationen können pro Mitglied ein Tages-, Wochen- oder Monatsbudget festlegen und Service-Schlüssel erstellen, die weiter funktionieren, wenn Personen das Team verlassen.
In der vollständigen Referenz öffnenStreaming
Streame Antworten mit der üblichen Streaming-Option deines SDKs. Details und Beispiele stehen in der Referenz.
In der vollständigen Referenz öffnenClaude- und Anthropic-Clients
Die API funktioniert auch mit den Anthropic-SDKs und mit Tools, die darauf aufbauen. Ändere die Basis-URL und den Schlüssel und behalte deinen Code.
In der vollständigen Referenz öffnenResponses API
Die Responses API ist in der Referenz beschrieben, mit Beispielen für Anfragen und Antworten.
In der vollständigen Referenz öffnenIdempotenz
Wiederhole Anfragen sicher. Wie Idempotenz funktioniert, steht in der Referenz.
In der vollständigen Referenz öffnenEmbeddings
Erstelle Embeddings über dieselbe Basis-URL und denselben Schlüssel. Die verfügbaren Modelle stehen in der Referenz.
In der vollständigen Referenz öffnenClient-Einrichtung
Einrichtungsanleitungen für Claude Code, Codex, Cursor, Cline, aider, Continue, opencode, Open WebUI, LibreChat, LangChain, LlamaIndex und das Vercel AI SDK. Hinweis: Router akzeptieren keine eigenen Tools. Für Coding-Tools nutze a2b-code oder ein einzelnes Modell.
Fehler
Fehler nutzen Standard-HTTP-Statuscodes mit einem JSON-Body. Die Referenz listet jeden Fehler und was du dagegen tun kannst.
In der vollständigen Referenz öffnen