Sawalni API
APIs
Documentation
Open portal ↗
Documentation
API documentation and guides
Introduction
Getting Started
Set up your account, create an API key, and make your first request
Authentication
How to authenticate your API requests using API keys
API Reference
Sawalni · Chat Completions
Generate conversational responses with sawalni-beta and sawalni-mini-beta
Tarjamli · Darija Translation
Translate Moroccan Arabic in Arabic or Latin script into English, French, or Modern Standard Arabic
Madmon · Embeddings
Create text embeddings for semantic search with madmon-beta
Streaming
Stream chat completion responses in real-time using SSE
Gherbal · Language Identification
Detect the language of text using Gherbal v4
Rescript · Transliteration
Transliterate words, sentences, and batches between writing systems with Sawtone-verified candidate sampling
Word Encoding
Encode words into dense phonetic, orthographic, and semantic embeddings with Sawtone v4
Tarakib · Multilingual NLP
Analyze part-of-speech, morphology, and dependency structure with language-specific evidence
Ziryab Rhymes & Lyrics
Score rhymes, search rhyme vocabularies, and evaluate lyric lines with Ziryab, built on Sawtone
Sawtitles · Speech Alignment
Align audio to text using phonetic forced alignment to produce timed SRT subtitles
Sawtitles · Word Alignment
Get per-word timestamps from audio using phonetic forced alignment
Daktilo · Speech Transcription
Transcribe audio to text with Arabic-optimized speech recognition
ASAT · Speech Synthesis
Generate speech audio from text with ASAT Speaks Any Text
Sawalni Atlas GPS
Search Moroccan places across scripts, inspect ranking signals, and build real routes
Akhbar · Moroccan News
Read today’s reviewed edition, clustered coverage, categories, and fresh news search
Maktaba · Web and Social Search
Search public web pages and social content, retrieve source pages, and submit research tasks
Apps
Batbot · Chatbots
Create a protected assistant with Khizana retrieval, Daktilo voice input, and optional ASAT spoken replies
Khizana · Knowledge Search
Build secure hybrid search, publish a drop-in widget or standalone page, and call it through the API
Guides
Rate Limits
Understanding rate limits, quotas, and best practices
Billing & Credits
How credits work, checking balance, and adding funds
Knowledge & Context Integration
Connect public sources and private document collections to grounded answers