Addis AI API Documentation

Welcome to the Addis AI API documentation. This guide will help you integrate Addis AI's language technologies into your applications, with a focus on Ethiopian languages.

🚀 Quick Start

Get up and running with Addis AI in minutes with our step-by-step guide

Get Started →

📱 Code Examples

Ready-to-use implementation examples in JavaScript, Python, and more

View Examples →

📘 API Reference

Comprehensive details on endpoints, parameters, and response formats

Explore API →

🔌 Integration Guides

Platform-specific guides for web, mobile, and server implementations

View Guides →

What is Addis AI?

Addis AI provides machine learning models and APIs specialized in Ethiopian languages, particularly Amharic and Afan Oromo. Our services include natural language processing, text-to-speech, and speech-to-text capabilities.

Key Capabilities

Chat Generation - Create natural language conversations in Amharic and Afan Oromo
Text-to-Speech - Convert text to natural-sounding speech in supported languages
Speech-to-Text - Transcribe spoken language to text
Multi-modal Support - Process text, audio, and image inputs together
Conversation Management - Maintain context across conversation turns

Popular Resources

🔧 Common Use Cases

📊 Best Practices

Get API Access

To use the Addis AI API, you need an API key. Sign up at the Addis AI Developer Portal to get started.

Quick Example

Here's how easy it is to get started with Addis AI:

// Simple text chat in JavaScript
const response = await fetch(
  "https://api.addisassistant.com/api/v1/chat_generate",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-API-Key": "YOUR_API_KEY",
    },
    body: JSON.stringify({
      prompt: "ኢትዮጵያ ዋና ከተማ ማን ናት?",
      target_language: "am",
    }),
  },
);

const data = await response.json();
console.log(data.response_text);

javascript