Getting started

The ASAS API gives you Arabic-first text-to-speech, speech-to-text, and retrieval-augmented search over your own documents, through one authenticated, metered gateway that runs entirely inside KSA regions.

Everything is versioned under /v1 and authenticated with a Bearer API key. This guide takes you from zero to your first synthesized audio clip.

Before you start

ASAS launches in a controlled mode, so access is granted, not instant:

1. Sign up at app.asas.flitc.tech and verify your email.
2. Wait for approval. New organizations start as pending_approval. A super admin approves your organization and grants your initial credits. You will get an email when you are approved.
3. Once approved, API key creation, playgrounds, and API access unlock.

1. Create an API key

In the dashboard, open API keys → Create key, name it, and choose scopes (tts:speak, stt:transcribe, rag:query).

Keys look like this — asas_live_… for production, asas_test_… for test mode:

asas_live_9fK2p…7Kf2

Keep keys server-side. Never ship them in a browser or mobile bundle.

2. Make your first call

Send up to 500 characters of Arabic text to the streaming TTS endpoint and save the audio. Pass your key as a Bearer token.

curl https://api.asas.flitc.tech/v1/tts/stream \
  -H "Authorization: Bearer $ASAS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "voice": "layan",
    "text": "أهلاً بك في أساس",
    "quality": "standard"
  }' \
  --output speech.mp3

Or with the TypeScript SDK (@asas/sdk, a typed client — currently v0):

import { AsasClient } from "@asas/sdk";

const asas = new AsasClient({ apiKey: process.env.ASAS_API_KEY! });

// Streams chunked audio; begins before synthesis finishes.
const audio = await asas.tts.stream({
  voice: "layan",
  text: "أهلاً بك في أساس",
  quality: "standard",
});

await Bun.write("speech.mp3", audio); // or pipe `audio` to any WritableStream

That's it — you just spent a few credits and got back Arabic speech. Check your Usage page in the dashboard; the request and its credit cost appear within seconds.

Core concepts

• Base URL — https://api.asas.flitc.tech/v1. All paths are versioned under /v1.
• Auth — Authorization: Bearer asas_live_…. See Authentication.
• Errors — RFC 9457 application/problem+json with code + request_id. See Errors.
• Credits — one unified balance, decremented per product at published rates. Your balance, rates, and consumption are always visible in the dashboard.
• Test mode — asas_test_… keys hit the real models with tiny throttled quotas and are excluded from billing.

Next steps