@zetiora/sdk for JavaScript & TypeScript.

npm install @zetiora/sdk
# or
bun add @zetiora/sdk

import { Zetiora, ZetioraError } from "@zetiora/sdk";

const zetiora = new Zetiora({
  apiKey: process.env.ZETIORA_API_KEY!,
  baseUrl: "https://YOUR-DOMAIN",
});

try {
  const reply = await zetiora.ai.chat({
    assistant: "qarl-buddy",
    messages: [{ role: "user", content: "Habari ya jioni?" }],
  });
  console.log(reply.message.content);
} catch (error) {
  if (error instanceof ZetioraError) {
    console.error(error.status, error.code, error.message);
  }
}

Any HTTP client works — the API is plain JSON. Python example:

import requests

res = requests.post(
    "https://YOUR-DOMAIN/api/public/v1/ai/chat",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={"assistant": "qarl-buddy",
          "messages": [{"role": "user", "content": "Mambo?"}]},
    timeout=120,
)
print(res.json()["message"]["content"])