Translation
High-accuracy neural machine translation for Ethiopian languages.
The Translation API leverages our specialized, fine-tuned models designed to master the linguistic complexity of Amharic (am), Afan Oromo (om), and English (en).
Our engine is rigorously trained on real-world conversational data and culturally accurate datasets. This ensures exceptional grammatical precision and deep cultural relevance, delivering translations that feel natural and authentic across these three key languages.
Endpoint
Use Cases
Public Service
Automatically translate government forms, announcements, and news between Amharic and Afan Oromo to reach wider audiences.
Marketplace
Enable real-time chat translation between buyers and sellers who speak different local languages or English.
Education
Translate educational materials and technical documentation from English into local languages to improve accessibility.
Usage Guide
Basic Translation
Translate text between any of the supported languages (am, om, en).
curl --location 'https://api.addisassistant.com/api/v1/translate' \
--header 'Content-Type: application/json' \
--header 'x-api-key: sk_YOUR_KEY' \
--data '{
"text": "ገበሬው ማሳውን ዘወትር ይጎበኛል",
"source_language": "am",
"target_language": "om"
}'const API_KEY = "sk_YOUR_KEY";
async function translateText() {
try {
const response = await fetch("https://api.addisassistant.com/api/v1/translate", {
method: "POST",
headers: {
"Content-Type": "application/json",
"x-api-key": API_KEY,
},
body: JSON.stringify({
text: "ገበሬው ማሳውን ዘወትር ይጎበኛል", // "The farmer visits his field regularly"
source_language: "am",
target_language: "om"
}),
});
const result = await response.json();
// Note: The translation is nested inside 'data'
console.log("Translation:", result.data.translation);
} catch (error) {
console.error("Translation failed:", error);
}
}
translateText();import requests
def translate_text():
url = "https://api.addisassistant.com/api/v1/translate"
headers = {
"Content-Type": "application/json",
"x-api-key": "sk_YOUR_KEY"
}
payload = {
"text": "ገበሬው ማሳውን ዘወትር ይጎበኛል",
"source_language": "am",
"target_language": "om"
}
try:
response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
result = response.json()
# Access nested data object
print(f"Translation: {result['data']['translation']}")
except Exception as e:
print(f"Error: {e}")
translate_text()API Reference
Request Parameters
Prop
Type
Response Schema
{
"status": "success",
"data": {
"translation": "Qotee bulaan yeroo mara maasaa isaa ni daawwata.",
"source_language": "am",
"target_language": "om",
"quality": "high",
"usage_metadata": {
"prompt_token_count": 113,
"candidates_token_count": 57,
"total_token_count": 170
}
}
}Prop
Type
Best Practices
Ensure the highest quality translations with these guidelines.
Input Fidelity
Spelling Matters: Ensure the source text has correct spelling. For Amharic, consistency in Fidel usage (e.g., using ሠ vs ሰ correctly) improves output quality.
Punctuation: Include proper punctuation (።, ?) to help the model understand sentence boundaries.
Supported Languages
Triangular Support: We support full bidirectional translation between all three languages:
Amharic (am)Oromo (om)English (en)Context
Full Sentences: Avoid translating single words in isolation if possible. Context helps resolve ambiguities (e.g., "eye" vs "spring" in Amharic).