API-Gateway für KI-Dienste: Ein Werkzeug gegen API-Chaos

Drei verschiedene API-Schlüssel, drei Abrechnungsdashboards und ständige Anpassungen des Code – das sind die typischen Hürden, bevor ein KI-Projekt überhaupt beginnt. Doch was, wenn es eine zentrale Lösung gäbe, die diese Schritte überflüssig macht?

Genau diese Erkenntnis führte zur Entwicklung von Apiarium, einem API-Gateway, das Entwicklern eine einzige Schnittstelle für mehrere KI-Anbieter bietet. Statt sich durch die Dokumentation verschiedener Anbieter zu kämpfen, genügt nun ein einziger Schlüssel und eine konsistente API-Struktur. Besonders für Side-Projekte und Prototypen soll damit der Einstieg in KI-Anwendungen deutlich vereinfacht werden.

Warum Apiarium statt LiteLLM oder OpenRouter?

Die bestehenden Alternativen wie LiteLLM oder OpenRouter bieten bereits starke Funktionen. Dennoch setzte der Entwickler von Apiarium auf einen anderen Ansatz, der sich gezielt an Entwickler richtet, die keine komplexe Infrastruktur benötigen:

• Kreditbasierte Abrechnung: Nutzer sehen auf einen Blick, was sie verbrauchen, ohne sich in tokenbasierte Preismodelle einarbeiten zu müssen. Die Kosten für Textgenerierung liegen je nach Modell zwischen 1 und 20 Credits, während Bilder 100 Credits und Sprachausgabe 10 Credits pro 1.000 Zeichen kosten.

• Einheitliche API für alle Dienste: Apiarium unterstützt nicht nur Textgenerierung, sondern auch Bildgenerierung, Sprachausgabe und Transkription über eine einzige API-Struktur. Neue Anbieter lassen sich ohne Änderungen an der API hinzufügen.

• Volle Kontrolle über die Infrastruktur: Wer Apiarium selbst hostet, behält die volle Kontrolle über Daten und Abrechnung – ideal für Entwickler, die ihre KI-Kosten transparent und sicher verwalten möchten.

• Einfache Preisgestaltung: Statt komplexer Preismodelle pro Modell gibt es eine klare Struktur, die für alle Anbieter einheitlich ist. Das reduziert die Einarbeitungszeit und vermeidet Überraschungen bei der Abrechnung.

Das Ziel von Apiarium sind nicht große Unternehmen mit hochskalierter KI-Infrastruktur, sondern Entwickler, die schnell und unkompliziert mit KI-Anwendungen experimentieren möchten. Statt stundenlang Konfigurationen zu wiederholen, können sie sich auf die eigentliche Entwicklung konzentrieren.

So funktioniert die Integration

Apiarium agiert als Mittler zwischen dem Client und verschiedenen KI-Anbietern. Die Struktur ist dabei bewusst einfach gehalten:

Client │ ▼ Apiarium
    ├── /llm → OpenAI, Anthropic (weitere folgen)
    ├── /image → gpt-image-1 (weitere folgen)
    ├── /tts → OpenAI TTS, ElevenLabs (demnächst)
    └── /transcribe → Whisper (weitere folgen)

Ein neues Modell oder ein zusätzlicher Anbieter lässt sich ohne Änderungen an der Client-API integrieren. Die Endpunkte bleiben identisch, sodass Entwickler ihre bestehenden Anwendungen mit minimalem Aufwand umstellen können.

Beispiel: Wechsel zwischen Modellen mit einem einzigen Aufruf

Ein typischer API-Aufruf für die Textgenerierung mit GPT-4o-mini sieht wie folgt aus:

curl -X POST  \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"Hallo"}]}'

Der Wechsel zu einem anderen Modell wie Claude-Haiku erfordert keinerlei Anpassungen am Code – nur die Modell-ID wird geändert:

curl -X POST  \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku","messages":[{"role":"user","content":"Hallo"}]}'

Technische Entscheidungen im Detail

Hinter Apiarium stecken mehrere Designentscheidungen, die den Unterschied zu anderen Gateways ausmachen:

• Konsistente Fehlerbehandlung: OpenAI und Anthropic unterscheiden sich stark in ihrer Fehlerstruktur. Apiarium normalisiert diese Unterschiede und gibt für alle Anbieter identische Fehlerformate zurück:

{
  "error": "Rate limit exceeded. Try again in 30 seconds.",
  "code": "rate_limit_exceeded",
  "retry_after": 30
}

• Provider-Abstraktion: Jeder Anbieter wird über einen Adapter integriert, der interne Daten in ein einheitliches Format übersetzt. Das vereinfacht die Erweiterung um neue Anbieter und reduziert die Komplexität im Hauptsystem.

• Streaming und Token-Verwaltung: Unterschiede in der Streaming-Verarbeitung oder Token-Abrechnung zwischen den Anbietern werden bereits im Adapter gekapselt, sodass der Client keine speziellen Anpassungen vornehmen muss.

Ein wichtiger Lernprozess war die Erkenntnis, dass die Provider-Abstraktion von Anfang an hätte durchdacht werden müssen. Statt nach und nach neue Anbieter hinzuzufügen, wäre ein modulares System, das von vornherein auf Erweiterbarkeit ausgelegt ist, effizienter gewesen. Jedes neue Modell brachte neue Herausforderungen bei Streaming, Token-Verwaltung oder Fehlerbehandlung mit sich – Herausforderungen, die durch eine frühere Planung hätten vermieden werden können.

Aktueller Stand und Ausblick

Apiarium ist erst seit wenigen Tagen öffentlich verfügbar, doch die Infrastruktur ist bereits stabil und alle Endpunkte funktionieren wie vorgesehen. Der Fokus liegt derzeit darauf, Feedback von Entwicklern zu sammeln, die ähnliche Probleme wie der Gründer erlebt haben.

Die zentrale Frage lautet: Löst Apiarium ein echtes Problem? Oder hat der Entwickler mit seiner Lösung eine Nische getroffen, die andere nicht als relevant empfinden?

Für den Gründer wäre es bereits ein Erfolg, wenn ein einziger Entwickler durch Apiarium das lästige Kopieren und Anpassen von API-Wrappern wie ai-utils.js vermeiden könnte. Doch die Zukunft des Projekts hängt davon ab, ob die Community die Vision teilt und Apiarium als nützliche Ergänzung im KI-Ökosystem wahrnimmt.