Docs/API reference
Create API key

Developer quickstart

Install the Saakh SDK, create a secret key in Settings, and call the full API from your app.

Saakh is the product; Mysa Technology is the company. Use the official Saakh SDK (@saakh/saakh) with one secret key and a /v1 base URL.

Create a key in Settings → API keys. New keys start with sk-saakh- and unlock the full API unless an admin restricts the key.

1. Install the SDK

npm install @saakh/saakh

2. Set environment variables

SAAKH_API_KEY=sk-saakh-your-secret-key
SAAKH_BASE_URL=https://api.ai.saakh.in/v1

3. Make your first request

Node.js

import Saakh from "@saakh/saakh";

const saakh = new Saakh();

const completion = await saakh.chat.completions.create({
  model: "automatic",
  messages: [{ role: "user", content: "Hello!" }],
});

console.log(completion.choices[0].message.content);

cURL

curl https://api.ai.saakh.in/v1/chat/completions \
  -H "Authorization: Bearer $SAAKH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"automatic","messages":[{"role":"user","content":"Hello!"}]}'

Base URL

Production: https://api.ai.saakh.in/v1
Local (this session): https://api.ai.saakh.in/v1

All API endpoints

One secret key (SAAKH_API_KEY) for every route. Chat uses the @saakh/saakh SDK; other capabilities use the same key over HTTP until SDK methods are added.

MethodPathUse with SDKDetails
POST/v1/chat/completionssaakh.chat.completions.create()Guide →
GET/v1/modelsHTTP (SDK models API coming soon)Guide →
POST/v1/embeddingsHTTP + Bearer keyGuide →
POST/v1/audio/transcriptionsHTTP + Bearer keyGuide →
POST/v1/audio/speechHTTP + Bearer keyGuide →
POST/v1/images/generationsHTTP + Bearer keyGuide →

Platform API (same key)

Base URL: https://api.ai.saakh.in (no /v1 suffix).

MethodPathCapability
POST/api/v1/ai/translateTranslation
POST/api/v1/ai/ocrOCR
POST/api/v1/ai/videosVideo
POST/api/v1/ai/web/searchWeb search
POST/api/v1/ai/web/scrapeScrape URL
WS/api/v1/ai/realtimeRealtime voice

Platform API guide →

SDK cheat sheet

npm install @saakh/saakh

# .env
SAAKH_API_KEY=sk-saakh-...
SAAKH_BASE_URL=https://api.ai.saakh.in/v1

import Saakh from "@saakh/saakh";
const saakh = new Saakh();

// Chat (SDK)
await saakh.chat.completions.create({
  model: "automatic",
  messages: [{ role: "user", content: "Hello" }],
});

// Other /v1 routes: same key, HTTP to SAAKH_BASE_URL + path
// Platform routes: https://api.ai.saakh.in/api/v1/ai/...

Authentication, billing, and limits: Authentication.