Client libraries
Akumi, in jouw taal.
Officiële client libraries voor PHP, TypeScript en Python, gegenereerd uit dezelfde OpenAPI-spec die de API draait. De methods, types en errors komen altijd overeen met het platform. Wijs er een naar je EU base_url, zet een key, en roep chat.create aan.
composer require, npm i, pip install
Dezelfde drie calls in elke taal. Alleen de importregel verschilt.
Zelfgeschreven clients verrotten.
Je kunt de API met curl aanroepen. Maar elk team dat dat doet, schrijft uiteindelijk hetzelfde leidingwerk: auth headers, retries, een streaming parser, het vertalen van statuscodes naar errors, en request- en responsetypen die afdrijven zodra de API verandert. Het is werk waarmee je je nergens onderscheidt, en het breekt stilletjes, in productie, de week nadat iemand een nieuwe parameter uitrolt.
Drie libraries, één API
Installeer hem met je package manager.
Authenticeer met een key en bereik elk endpoint: chat, models, memory, threads en de audit log. Elke library staat in een eigen repository en registry, met eigen versionering.
PHP
akumi-cloud/sdk. Een PSR-18 HTTP client met een automatisch gevonden Laravel-bridge: service provider, config en facade. Installeren met composer require akumi-cloud/sdk.
Bekijk op GitHubTypeScript
@akumi/sdk. Native fetch, nul runtime dependencies, zowel ESM als CJS, en volledige type definitions. Node 18 en hoger. Installeren met npm i @akumi/sdk.
Bekijk op GitHubPython
akumi. Gebouwd op httpx, met zowel een synchrone als een asynchrone client. Python 3.9 en hoger. Installeren met pip install akumi.
Bekijk op GitHub
Gegenereerd uit de spec
Nooit uit de pas.
De libraries komen uit de OpenAPI-spec die de API definieert, dus de client kan niet afdrijven van het platform.
Gegenereerd, niet met de hand geschreven
Elke SDK komt uit dezelfde OpenAPI-spec die de API definieert, via onze eigen generator. Krijgt de API een parameter, dan worden de libraries opnieuw gegenereerd.
Veilig door constructie
Je API-key gaat altijd alleen mee in de Authorization header, in elke taal. Nooit in een query string, nooit in de body. Dezelfde regel wordt afgedwongen in de transportlaag van PHP, TypeScript en Python.
Sync, async, streaming
Token streaming is een native generator of async iterator, geen callback. Een async client in Python, async generators in TypeScript en PHP. Retries bij tijdelijke fouten en getypeerde exceptions per status, ingebouwd.
Heb je al een OpenAI-client?
Houd hem.
De inference-API is OpenAI-compatible, dus je bestaande client werkt door één base_url te wijzigen. Grijp naar een Akumi SDK wanneer je getypeerde toegang wilt tot wat van ons is.
Je OpenAI-client blijft werken
Wijs de base_url naar Akumi en zet je key. Geen rewrite, geen nieuwe dependency, standaard EU-resident.
De SDK is voor de eigen onderdelen
Memory, conversation threads, de audit log en de routeringsparameters, volledig getypeerd in plaats van JSON met strings.
Geen lock-in
Het wire format is gewone OpenAI-compatible HTTP, beschreven in een spec die je kunt lezen. Weggaan is de base_url terugzetten.
Eén client, elke service
De firewall, retrieval, routing en de cache gaan mee als parameters op dezelfde chat-call. Er zijn geen aparte endpoints om aan te sluiten.
FAQ
Vragen die mensen stellen over de SDKs.
- Heb ik een SDK nodig om Akumi te gebruiken?
- Nee. De inference-API is OpenAI-compatible, dus een bestaande OpenAI-client werkt door één base_url te wijzigen. De SDKs bestaan voor de onderdelen die van ons zijn: memory, threads, de audit log en de routeringsparameters.
- Welke talen worden ondersteund?
- PHP, TypeScript en Python, elk in een eigen registry met eigen versionering. Elke andere taal kan de API rechtstreeks aanroepen, en de OpenAPI-spec staat online zodat je zelf een client kunt genereren.
- Hoe blijven de libraries actueel?
- Ze worden gegenereerd uit dezelfde OpenAPI-spec die de API definieert in plaats van met de hand geschreven, dus een nieuwe parameter op het platform wordt een nieuwe parameter in elke library.
- Waar gaat mijn API-key heen?
- In de Authorization header, in elke taal. Nooit in een query string en nooit in de body. De regel wordt afgedwongen in de transportlaag van alle drie de libraries.
- Wordt streaming ondersteund?
- Ja. Token streaming is een native generator of async iterator in plaats van een callback: een async client in Python, en async generators in TypeScript en PHP.
- Zijn de SDKs open source?
- Elke library staat in een eigen publieke repository en package registry, dus je kunt lezen wat je dependency doet voordat je hem installeert.
Installeer de SDK. Live binnen minuten.
Voeg een betaalmethode toe, maak een key aan, installeer je library, en doe je eerste EU-resident call voordat de koffie koud is.