Translation
Translate text between Amharic, Afaan Oromo, and English.
The Translation API supports bidirectional translation between Amharic (am), Afaan Oromo (om), and English (en). All six source-to-target language combinations are available through the REST API and official SDKs.
Use Cases
Public Service
Automatically translate government forms, announcements, and news between Amharic and Afaan 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).
import AddisAI from "addisai";
const addis = new AddisAI();
const result = await addis.translate.create({
text: "ገበሬው ማሳውን ዘወትር ይጎበኛል",
from: "am",
to: "om",
});
console.log(result.text);from addisai import AddisAI
addis = AddisAI()
result = addis.translate.create(
text="ገበሬው ማሳውን ዘወትር ይጎበኛል",
source="am",
target="om",
)
print(result["text"])curl --location 'https://api.addisassistant.com/api/v1/translate' \\
--header 'Content-Type: application/json' \\
--header 'x-api-key: $ADDIS_API_KEY' \\
--data '{
"text": "ገበሬው ማሳውን ዘወትር ይጎበኛል",
"source_language": "am",
"target_language": "om"
}'Available Parameters
| Value | Node.js | Python | REST | Required |
|---|---|---|---|---|
| Text to translate | text | text | text | Yes |
| Source language | from | source | source_language | Yes: am, om, or en |
| Target language | to | target | target_language | Yes: am, om, or en |
Source and target must be different. Translation is supported in both directions between Amharic, Afaan Oromo, and English.
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
Amharic ↔ Afaan OromoAmharic ↔ EnglishAfaan Oromo ↔ EnglishContext
Full Sentences: Avoid translating single words in isolation if possible. Context helps resolve ambiguities (e.g., "eye" vs "spring" in Amharic).