Client Libraries
Akumi, in Ihrer Sprache.
Offizielle Client Libraries für PHP, TypeScript und Python, generiert aus derselben OpenAPI-Spezifikation, die die API betreibt. Methoden, Typen und Fehler passen immer zur Plattform. Richten Sie eine auf Ihre EU base_url, setzen Sie einen Key und rufen Sie chat.create auf.
composer require, npm i, pip install
Dieselben drei Calls in jeder Sprache. Nur die Importzeile unterscheidet sich.
Selbst gebaute Clients verrotten.
Sie können die API mit curl aufrufen. Aber jedes Team, das das tut, schreibt am Ende dieselbe Verkabelung: Auth-Header, Retries, einen Streaming-Parser, die Zuordnung von Status zu Fehlern, und Request- und Response-Typen, die abdriften, sobald sich die API ändert. Es ist Arbeit, die niemanden unterscheidet, und sie bricht leise, in Produktion, in der Woche, nachdem jemand einen neuen Parameter ausgeliefert hat.
Drei Libraries, eine API
Installieren Sie sie mit Ihrem Paketmanager.
Authentifizieren Sie sich mit einem Key und erreichen Sie jeden Endpoint: Chat, Models, Memory, Threads und den Audit Log. Jede Library liegt in einem eigenen Repository und Registry, mit eigener Versionierung.
PHP
akumi-cloud/sdk. Ein PSR-18 HTTP-Client mit automatisch erkannter Laravel-Bridge: Service Provider, Config und Facade. Installation mit composer require akumi-cloud/sdk.
Auf GitHub ansehenTypeScript
@akumi/sdk. Natives fetch, null Runtime-Abhängigkeiten, ESM und CJS, und vollständige Typdefinitionen. Node 18 und höher. Installation mit npm i @akumi/sdk.
Auf GitHub ansehenPython
akumi. Gebaut auf httpx, mit einem synchronen und einem asynchronen Client. Python 3.9 und höher. Installation mit pip install akumi.
Auf GitHub ansehen
Aus der Spezifikation generiert
Nie aus dem Takt.
Die Libraries entstehen aus der OpenAPI-Spezifikation, die die API definiert, der Client kann also nicht von der Plattform abdriften.
Generiert, nicht handgeschrieben
Jedes SDK entsteht aus derselben OpenAPI-Spezifikation, die die API definiert, durch unseren eigenen Generator. Bekommt die API einen Parameter, werden die Libraries neu generiert.
Sicher durch Bauweise
Ihr API-Key reist immer nur im Authorization-Header, in jeder Sprache. Nie in einer Query-String, nie im Body. Dieselbe Regel gilt in der Transportschicht von PHP, TypeScript und Python.
Sync, async, Streaming
Token-Streaming ist ein nativer Generator oder Async Iterator, kein Callback. Ein asynchroner Client in Python, Async Generators in TypeScript und PHP. Retries bei vorübergehenden Fehlern und typisierte Exceptions pro Status, eingebaut.
Schon einen OpenAI-Client?
Behalten Sie ihn.
Die Inference-API ist OpenAI-kompatibel, Ihr bestehender Client funktioniert also, indem Sie eine base_url ändern. Zum Akumi SDK greifen Sie, wenn Sie typisierten Zugriff auf das Eigene wollen.
Ihr OpenAI-Client läuft weiter
Richten Sie seine base_url auf Akumi und setzen Sie Ihren Key. Keine Neuentwicklung, keine neue Abhängigkeit, standardmäßig EU-resident.
Das SDK ist für die eigenen Teile
Memory, Conversation Threads, der Audit Log und die Routing-Parameter, vollständig typisiert statt als JSON aus Strings.
Kein Lock-in
Das Wire-Format ist schlichtes OpenAI-kompatibles HTTP, beschrieben in einer Spezifikation, die Sie lesen können. Weggehen heißt, die base_url zurückzustellen.
Ein Client, jeder Service
Firewall, Retrieval, Routing und Cache reisen als Parameter auf demselben Chat-Call mit. Es gibt keine separaten Endpoints anzubinden.
FAQ
Fragen, die zu den SDKs gestellt werden.
- Brauche ich ein SDK, um Akumi zu nutzen?
- Nein. Die Inference-API ist OpenAI-kompatibel, ein bestehender OpenAI-Client funktioniert also durch das Ändern einer base_url. Die SDKs gibt es für die Teile, die unsere sind: Memory, Threads, der Audit Log und die Routing-Parameter.
- Welche Sprachen werden unterstützt?
- PHP, TypeScript und Python, jeweils in einer eigenen Registry mit eigener Versionierung. Jede andere Sprache kann die API direkt aufrufen, und die OpenAPI-Spezifikation ist veröffentlicht, damit Sie sich einen Client generieren können.
- Wie bleiben die Libraries aktuell?
- Sie werden aus derselben OpenAPI-Spezifikation generiert, die die API definiert, statt von Hand geschrieben, ein neuer Parameter auf der Plattform wird also ein neuer Parameter in jeder Library.
- Wohin geht mein API-Key?
- In den Authorization-Header, in jeder Sprache. Nie in eine Query-String und nie in den Body. Die Regel gilt in der Transportschicht aller drei Libraries.
- Wird Streaming unterstützt?
- Ja. Token-Streaming ist ein nativer Generator oder Async Iterator statt eines Callbacks: ein asynchroner Client in Python und Async Generators in TypeScript und PHP.
- Sind die SDKs Open Source?
- Jede Library liegt in einem eigenen öffentlichen Repository und Paket-Registry, Sie können also lesen, was Ihre Abhängigkeit tut, bevor Sie sie installieren.
Installieren Sie das SDK. In Minuten live.
Fügen Sie eine Zahlungsmethode hinzu, erstellen Sie einen Key, installieren Sie Ihre Library, und machen Sie Ihren ersten EU-residenten Call, bevor der Kaffee kalt ist.