API overview
Base URLs, authentication, endpoints, and native REST response shapes for the Addis AI API.
Authentication
Authentication is handled via a secret x-api-key header.
Base URLs
REST API requests use the following production base URL:
https://api.addisassistant.comRealtime voice uses a separate WebSocket endpoint:
wss://relay.addisassistant.com/wsFor Addis Voices 2 text-to-speech streaming, use wss://api.addisassistant.com/api/v1/realtime/voice with a scoped session ticket. Follow the Streaming text-to-speech guide for session creation and SDK release availability.
Endpoints
| Capability | Endpoint | Method |
|---|---|---|
| Chat and Text Generation | /api/v1/chat_generate | POST |
| Text-to-Speech (Addis Voices 2) | /api/v1/voice/generations | POST |
| Speech-to-Text | /api/v2/stt | POST |
| Translation | /api/v1/translate | POST |
| Multimodal | /api/v1/chat_generate | POST multipart/form-data |
| Realtime Voice | wss://relay.addisassistant.com/ws | WebSocket |
Native REST responses
The API structure depends on the endpoint.
The SDK exposes this result through response.choices and response.usage. The JSON below is the native REST response.
{
"response_text": "በአሁኑ ጊዜ በኢትዮጵያ ውስጥ 12 ክልሎች አሉ።...",
"finish_reason": "stop",
"usage_metadata": {
"prompt_token_count": 8,
"candidates_token_count": 25,
"total_token_count": 33
},
"modelVersion": "Addis-፩-አሌፍ"
}The SDK returns text, confidence, and usage. The JSON below is the native REST response.
{
"status": "success",
"data": {
"transcription": "ሊያሳውቁ ይችላሉ ነገር ግን የበለጠ እየታወቁ በመጡ ቁጥር ደግሞ ይበልጥ ይነሳሉ የተረጋገጠ ልብና ነበር ያለው ሰው የሃሳብ የድርጊት ዝም",
"usage_metadata": {
"totalBilledDuration": "15s",
"requestId": "69b60667-0000-2a1e-b6d3-d4f547fe6724"
}
},
"confidence": 0.98276204
}Edit on GitHub
Last updated on