API စာရွက်စာတမ်း
ကျွန်ုပ်တို့၏ရိုးရှင်းသော REST API နှင့်အတူသင်၏ application များထဲသို့စွမ်းအားရှိသောဘာသာပြန်ချက်ကိုပေါင်းစပ်.
စတင်ခြင်း
The TranslateAPI providesasimple REST interface for translating text between 180+ languages. All API endpoints return JSON responses.
1. သင်၏ API ကို Key ကိုရယူပါ
အခမဲ့အကောင့်တစ်ခုဖန်တီးပြီး dashboard မှသင်၏ API key ကို generate:
- တွင်မှတ်ပုံတင်ပါ translateapi.ai/signup
- ဆီသွားပါ အညွှန်းစာမျက်နှာ → API ကီးများ
- ကလစ်နှိပ်ပါ "Create API Key ကို" နှင့်သင်၏ key ကိုကူးယူ
API ကီးများ စတင်သည် ta_ 56 hex စာလုံးများမှတဆင့်လိုက်သည်။
https://api.translateapi.ai/api/v1/2. သင်၏ပထမဦးဆုံးတောင်းဆိုချက်ကိုလုပ်ပါ
သင့်ရဲ့ dashboard မှ key ကိုနှင့်အတူ YOUR_API_KEY ကိုအစားထိုး:
curl -X POST https://api.translateapi.ai/api/v1/translate/ \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"text": "Hello, world!",
"target_language": "es"
}'
import requests
response = requests.post(
"https://api.translateapi.ai/api/v1/translate/",
headers={
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
},
json={
"text": "Hello, world!",
"target_language": "es"
}
)
result = response.json()
print(result["translated_text"]) # "Hola, mundo!"
const response = await fetch("https://api.translateapi.ai/api/v1/translate/", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify({
text: "Hello, world!",
target_language: "es"
})
});
const result = await response.json();
console.log(result.translated_text); // "Hola, mundo!"
$ch = curl_init("https://api.translateapi.ai/api/v1/translate/");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer YOUR_API_KEY",
"Content-Type: application/json"
],
CURLOPT_POSTFIELDS => json_encode([
"text" => "Hello, world!",
"target_language" => "es"
])
]);
$result = json_decode(curl_exec($ch), true);
echo $result["translated_text"]; // "Hola, mundo!"
payload := strings.NewReader(`{
"text": "Hello, world!",
"target_language": "es"
}`)
req, _ := http.NewRequest("POST", "https://api.translateapi.ai/api/v1/translate/", payload)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
var result map[string]interface{}
json.NewDecoder(resp.Body).Decode(&result)
fmt.Println(result["translated_text"]) // "Hola, mundo!"
var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var content = new StringContent(
JsonSerializer.Serialize(new {
text = "Hello, world!",
target_language = "es"
}),
Encoding.UTF8,
"application/json"
);
var response = await client.PostAsync("https://api.translateapi.ai/api/v1/translate/", content);
var result = JsonSerializer.Deserialize<JsonElement>(
await response.Content.ReadAsStringAsync()
);
Console.WriteLine(result.GetProperty("translated_text")); // "Hola, mundo!"
တုံ့ပြန်မှု
{
"translated_text": "Hola, mundo!",
"source_language": "en",
"target_language": "es",
"translations": {
"es": "Hola, mundo!"
},
"character_count": 13,
"translation_time": 0.45
}
အတည်ပြုခြင်း
API key ကိုသုံးပြီးသင့်ရဲ့တောင်းဆိုမှုများကိုစစ်ဆေးပါ. သင်သည်သင်၏ API key ကိုဖန်တီးနိုင်ပါတယ် အညွှန်းစာမျက်နှာ.
ခေါင်းစီး အတည်ပြုခြင်း (အကြံပြု)
Authorization: Bearer ta_your_api_key_here
ခေါင်းစီးစာမျက်နှာ
Authorization: ApiKey ta_your_api_key_here
မေးမြန်းချက် ပမာဏ
https://api.translateapi.ai/api/v1/translate/?api_key=ta_your_api_key_here
စာသားကို ဘာသာပြန်
တစ်ခုတည်းသောရည်မှန်းချက်ဘာသာစကားသို့စာသားကိုဘာသာပြန်ဆို။
POST https://api.translateapi.ai/api/v1/translate/
တောင်းဆိုချက်ကိုယ်ထည်
| အညွှန်းကိန်း | အမျိုးအစား | လိုအပ်သည် | ဖော်ပြချက် |
|---|---|---|---|
text |
string | အင်း | ဘာသာပြန်ရန်စာသား (max 50,000 အက္ခရာများ) |
target_language |
string | ဟုတ်ကဲ့* | Target language code (e.g., "es", "fr", "de") |
source_language |
string | မဟုတ်ပါ | Source language code. Default: "auto" (auto-detect) |
engine |
string | မဟုတ်ပါ | ဘာသာပြန်ချက်အင်ဂျင်: "အလိုအလျောက်" (စံ), "huggingface", သို့မဟုတ် "madlad". ဘာသာပြန်ချက် Models ကိုကြည့်ပါ. ဘာသာပြန်မော်ဒယ်များ. |
* အသုံးပြုမှု target_language တစ်ဦးတည်းဘာသာစကားသို့မဟုတ်အတွက် (string) target_languages အပေါင်းတို့အတွက် (array) ။ ကြည့်ပါ Multi-ရည်မှန်းချက်ဘာသာပြန်ချက်.
တုံ့ပြန်မှု
{
"translated_text": "Hola, mundo!",
"source_language": "en",
"target_language": "es",
"translations": {
"es": "Hola, mundo!"
},
"character_count": 13,
"translation_time": 0.45
}
source_language ဒါမှမဟုတ် သတ်မှတ်ပါ "auto" အလိုအလျောက်အရင်းအမြစ်ဘာသာစကားကိုရှာဖွေတွေ့ရှိရန်. ရှာဖွေတွေ့ရှိဘာသာစကားကိုတွင်ပြန်လာသည် source_language တုံ့ပြန်မှု Field ကို။
Multi-ရည်မှန်းချက်ဘာသာပြန်ချက်
တစ်ခုတည်းသောတောင်းဆိုချက်တွင်ဘာသာစကားများစွာသို့စာသားကိုဘာသာပြန်ဆို. တစ်ခုတည်းသောဘာသာပြန်ချက်အဖြစ်တူညီသော endpoint ကိုအသုံးပြုသည်.
POST https://api.translateapi.ai/api/v1/translate/
တောင်းဆိုချက်ကိုယ်ထည်
{
"text": "Hello, world!",
"target_languages": ["es", "fr", "de", "ja"],
"source_language": "en"
}
သုံးစွဲမှု target_languages (array) အစား target_language အများအပြားရည်မှန်းချက်များအတွက် (string) ။
တုံ့ပြန်မှု
{
"source_language": "en",
"translations": {
"es": "Hola, mundo!",
"fr": "Bonjour, monde!",
"de": "Hallo, Welt!",
"ja": "こんにちは、世界!"
},
"character_count": 52,
"translation_time": 2.31
}
ဘာသာပြန်ချက်
async စီမံခန့်ခွဲမှုနှင့်အတူတစ်ချိန်တည်းမှာစာသားပေါင်းများစွာကိုဘာသာပြန်ဆို. ရလဒ်များအတွက် batch နှင့်မဲဆွယ်စည်းရုံးရေးတင်သွင်း.
POST https://api.translateapi.ai/api/v1/translate/batch/
ခြေလှမ်း 1: Batch တင်သွင်း
curl -X POST https://api.translateapi.ai/api/v1/translate/batch/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"texts": ["Hello", "Goodbye", "Thank you"],
"target_language": "es",
"source_language": "en"
}'
တုံ့ပြန်မှု (HTTP 202 လက်ခံ)
{
"job_id": "67535b2b-c9e3-4f82-9499-e237edbc1dd8",
"status": "pending",
"total_texts": 3,
"queue_position": 1,
"source_language": "en",
"target_languages": ["es"],
"character_count": 22,
"credits_remaining": -1,
"poll_url": "https://api.translateapi.ai/api/v1/jobs/67535b2b-c9e3-4f82-9499-e237edbc1dd8/"
}
ခြေလှမ်း 2: ရလဒ်များအတွက် Poll
GET https://api.translateapi.ai/api/v1/jobs/{job_id}/
ရွေးကောက်ပွဲဥပမာ (Python)
import time, requests
job_id = response.json()["job_id"]
total = response.json()["total_texts"]
headers = {"Authorization": "Bearer YOUR_API_KEY"}
print(f"Batch submitted: {total} texts (job {job_id})")
while True:
result = requests.get(f"https://api.translateapi.ai/api/v1/jobs/{job_id}/", headers=headers).json()
status = result["status"]
processed = result.get("processed_texts", 0)
progress = result.get("progress_percentage", 0)
if status == "completed":
print(f"Done: {processed}/{total} in {result.get('processing_time', 0):.1f}s")
translations = result["result_data"]["translations"]
break
elif status == "failed":
raise Exception(result.get("error_message", "Translation failed"))
elif status == "pending":
print(f"Queued (position {result.get('queue_position', '?')})")
else:
print(f"[{status}] {processed}/{total} ({progress:.0f}%)")
time.sleep(3)
တုံ့ပြန်မှု (ပြီးစီး)
{
"job_id": "67535b2b-...",
"status": "completed",
"processed_texts": 3,
"total_texts": 3,
"progress_percentage": 100.0,
"processing_time": 10.65,
"result_data": {
"translations": ["Hola", "Adiós", "Gracias"],
"source_language": "en",
"target_language": "es",
"character_count": 22,
"processing_time": 10.65
}
}
အရှိန်အဟုန် ခြေရာခံခြင်း
| ဧရိယာ | ဖော်ပြချက် |
|---|---|
status |
pending (တန်းစီ, တစ်ဦး GPU အလုပ်သမားစောင့်ဆိုင်း), processing (တက်ကြွစွာဘာသာပြန်ဆို), completed, failed |
processed_texts |
[Error: UNIQUE constraint failed: translations_translation.textbase_id, translations_translation.language_id] |
progress_percentage |
[Error: UNIQUE constraint failed: translations_translation.textbase_id, translations_translation.language_id] |
queue_position |
အခြေအနေသည် "စောင့်ဆိုင်းနေသည်" (1 = နောက်ဆုံးပေါ်). စီမံခန့်ခွဲမှုသို့မဟုတ်ပြီးဆုံးသောအခါ Null. စောင့်ဆိုင်းချိန်ကိုခန့်မှန်းရန်နှင့်သင့်အသုံးပြုသူများအားစောင့်ဆိုင်းနေသောအခြေအနေကိုပြရန်ဤကိုအသုံးပြုပါ။ |
processing_time |
စက္ကန့်အတွင်းစုစုပေါင်းစီမံခန့်ခွဲမှုအချိန် (ပြီးဆုံးတဲ့အခါရရှိနိုင်). |
ဘာသာစကားစုံ အုပ်စုလိုက်
တစ်ပြိုင်နက်တည်းဘာသာစကားများစွာသို့စာသားများစွာကိုဘာသာပြန်ဆို:
{
"texts": ["Hello", "Goodbye"],
"target_languages": ["es", "fr"],
"source_language": "en"
}
_D ပြီးဆုံးသော ရလဒ်ဒေတာ
{
"translations": [
{"es": "Hola", "fr": "Bonjour"},
{"es": "Adiós", "fr": "Au revoir"}
],
"source_language": "en",
"target_languages": ["es", "fr"],
"character_count": 24,
"processing_time": 2.45
}
မေးမြန်းချက် ပရာမီတာများ
| အညွှန်းကိန်း | အမျိုးအစား | လိုအပ်သည် | ဖော်ပြချက် |
|---|---|---|---|
texts |
array | အင်း | ဘာသာပြန်ရန် စာကြောင်းများ အစု |
target_language |
string | ဟုတ်ကဲ့* | တစ်ခုတည်းသောဘာသာစကားအတွက်ရည်မှန်းချက်ဘာသာစကားကုဒ် |
target_languages |
array | ဟုတ်ကဲ့* | ဘာသာစကားများစွာအတွက်ရည်မှန်းချက်ဘာသာစကားကုဒ်များ |
source_language |
string | မဟုတ်ပါ | Source language code. Default: "auto" |
* တစ်ခုခုကိုပေး target_language သို့မဟုတ် target_languages, နှစ်ဦးစလုံးမဟုတ်ပါ။
[Error: UNIQUE constraint failed: translations_translation.textbase_id, translations_translation.language_id]
- Send 1 target language per batch request. This keeps each batch fast and makes progress easy to track.
- 50-100 စာသားများမှာအစုလိုက်အပြုံလိုက်ထား. အသေးစားအစုလိုက်အပြုံလိုက်ပိုမိုမြန်ဆန်ပြီးစီးနှင့်သင်ပိုမိုမကြာခဏတိုးတက်မှုသတင်းအချက်အလက်ပေး.
- သင်လိုအပ်သလိုများစွာသော batch အလုပ်များတင်သွင်း - ကျွန်တော်တို့ရဲ့ GPU cluster ကို auto-scales တောင်းဆိုမှုကိုင်တွယ်ရန်။ အလုပ်များမျိုးစုံ instances များအကြားတပြိုင်နက်တည်းတွင်စီမံခန့်ခွဲကြသည်။
- [Error: UNIQUE constraint failed: translations_translation.textbase_id, translations_translation.language_id]
- Poll အားလုံး 3-5 စက္ကန့်. ပိုမိုမကြာခဏ polling လုပ်ငန်းစဉ်အရှိန်မမြှင့်.
စာရွက်စာတမ်း ဘာသာပြန်
formatting ကိုထိန်းသိမ်းထားစဉ်အပြည့်အဝစာရွက်စာတမ်းများကိုဘာသာပြန်ဆို။ အမျိုးမျိုးသောဖိုင်အမျိုးအစားများကိုထောက်ခံသည်။
POST https://api.translateapi.ai/api/v1/translate/document/
တောင်းဆိုချက် (multipart/form-data)
| အညွှန်းကိန်း | အမျိုးအစား | လိုအပ်သည် | ဖော်ပြချက် |
|---|---|---|---|
file |
file | အင်း | ဘာသာပြန်ရန်စာရွက်စာတမ်း (max 10MB) |
target_language |
string | အင်း | Target language code (e.g., "es", "fr", "de") |
source_language |
string | မဟုတ်ပါ | Source language code. Default: "auto" (auto-detect) |
ထောက်ပံ့ထားသောဖိုင်အမျိုးအစားများ
စာရွက်စာတမ်းများ
.txt- ရိုးရိုးစာသားဖိုင်များ.docx- Word စာရွက်စာတမ်း.pdf- PDF စာရွက်စာတမ်းများ (စကင်ဖတ်စစ်ဆေးအပါအဝင်)
ဒေတာနှင့် နေရာချထားမှု
.json- JSON ဖိုင်များ (string တန်ဖိုးများကိုဘာသာပြန်).xml- XML ဖိုင်များ.srt- စာတန်းထိုးဖိုင်များ.po/.pot- Gettext ဘာသာပြန်ဖိုင်များ
ရုပ်ပုံများ (OCR)
.jpg/.jpeg- JPEG ရုပ်ပုံများ (OCR).png- PNG ရုပ်ပုံများ (OCR).tiff/.tif- TIFF ရုပ်ပုံများ (OCR).bmp- BMP ရုပ်ပုံများ (OCR).webp- WebP ရုပ်ပုံများ (OCR)
ဥပမာ (cURL)
# Translate a Word document
curl -X POST https://api.translateapi.ai/api/v1/translate/document/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@document.docx" \
-F "target_language=es" \
-F "source_language=en"
# Translate text from an image (OCR)
curl -X POST https://api.translateapi.ai/api/v1/translate/document/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@scanned_page.jpg" \
-F "target_language=es" \
-F "source_language=en"
တုံ့ပြန်မှု
{
"id": 123,
"original_filename": "document.docx",
"file_type": "docx",
"source_language": "en",
"target_language": "es",
"status": "completed",
"character_count": 5420,
"translated_file_url": "/media/translated/document_es.docx",
"created_at": "2024-01-15T10:30:00Z",
"completed_at": "2024-01-15T10:30:05Z"
}
GET https://api.translateapi.ai/api/v1/translate/document/{id}/
စာရွက်စာတမ်းဘာသာပြန်ချက်၏အခြေအနေကိုစစ်ဆေးသို့မဟုတ်ဒေါင်းလုပ် URL ကိုရယူပါ။
အခြေအနေ တန်ဖိုးများ
pending |
ဖိုင်တင်ပြီး၊ စီမံရန်စောင့်နေသည် |
processing |
ဘာသာပြန်နေသည် |
completed |
ဘာသာပြန်ပြီးစီး, download လုပ်နိုင်ပါတယ် |
failed |
ဘာသာပြန်ချက်မအောင်မြင် (error_message ကိုစစ်ဆေးပါ) |
ထောက်ပံ့ထားသော ဘာသာစကားများ
ထောက်ပံ့ထားသော ဘာသာစကားအားလုံး၏ စာရင်းကို ရယူပါ။
GET https://api.translateapi.ai/api/v1/translate/languages/
တုံ့ပြန်မှု
{
"count": 186,
"results": [
{"iso": "en", "name": "English", "en_label": "English"},
{"iso": "es", "name": "Español", "en_label": "Spanish"},
{"iso": "fr", "name": "Français", "en_label": "French"},
...
]
}
ဘာသာပြန်မော်ဒယ်များ
ကျွန်ုပ်တို့သည်ကျွန်ုပ်တို့၏ကိုယ်ပိုင် GPU အခြေခံအဆောက်အအုံပေါ်တွင်လည်ပတ်နေသော state-of-the-art open source ဘာသာပြန်ချက်မော်ဒယ်များကိုအသုံးပြုသည်။ အားလုံးမော်ဒယ်များသည်ကုန်သွယ်ရေးလိုင်စင်ရကြသည် (Apache 2.0) ။
| မော်ဒယ် | ဘာသာစကားများ | အကောင်းဆုံး |
|---|---|---|
| Helsinki-NLP/opus-mt | 50+ ဘာသာစကားစုံ | ယေဘုယျဘာသာစကားများ (EN, ES, FR, DE, IT, PT, RU, ZH, JA, စသည်တို့ကို) |
| Google MADLAD-400 | 400+ ဘာသာစကားများ | ရှားပါးဘာသာစကားများ, စုံလင်သောကာကွယ်မှု |
အဆိုပါ API ကိုအလိုအလျောက်သင်၏ဘာသာစကားစုံတွဲအတွက်အကောင်းဆုံးမော်ဒယ်ကို selects. You can optionally specify an engine ပမာဏ -
| အင်ဂျင် | ဖော်ပြချက် |
|---|---|
"auto" |
ပထမဦးဆုံး HuggingFace ကိုစမ်းသပ်, MADLAD-400 သို့ပြန်ကျဆင်း |
"huggingface" |
Force HuggingFace/MarianMT (အမြန်ဆုံး, 50+ ဘာသာစကားများ) |
"madlad" |
အင်အား MADLAD-400 (400+ ဘာသာစကားများ) |
အမှား ကိုင်တွယ်ခြင်း
အဆိုပါ API ကိုအောင်မြင်မှုသို့မဟုတ်ပျက်ကွက်ကိုပြသရန်စံ HTTP အခြေအနေကုဒ်များကိုအသုံးပြုသည်။
| ကုဒ် | ဖော်ပြချက် |
|---|---|
| 200 | အောင်မြင်မှု |
| 202 | လက်ခံသည် — အုပ်စုလိုက်အလုပ်ကို အောင်မြင်စွာ တန်းစီသည် |
| 400 | Bad Request — မမှန်ကန် parameters တွေကို (စာသားပျောက်ဆုံးနေ, မထောက်ခံတဲ့ဘာသာစကား, စသည်တို့ကို) |
| 401 | Unauthorized - မမှန်ကန်သောသို့မဟုတ်ပျောက်ဆုံး API key ကို |
| 402 | ငွေပေးချေမှုလိုအပ်ပါတယ် — Character credits exhausted. Upgrade your plan or purchaseatop-up. |
| 403 | တားမြစ် — API ကို key ကိုလိုအပ်သောနယ်ပယ်သို့မဟုတ် IP ကို whitelist မှာမဟုတ်သောမရှိ |
| 503 | ဝန်ဆောင်မှုမရရှိနိုင် - ဘာသာပြန်ချက်အင်ဂျင် ယာယီအောက် |
ချို့ယွင်းချက် တုံ့ပြန်မှု ပုံစံ
{
"error": "insufficient_credits",
"credits_remaining": 0
}
အသုံးပြုမှု ကနိမ့်ကျမှု
TranslateAPI has no request rate limits. All requests are queued and processed by our auto-scaling GPU cluster. Your plan determines your monthly character allowance:
| အစီအစဉ် | အက္ခရာများ/လ | အုပ်စုလိုက် API | စာရွက်စာတမ်းများ | စျေးနှုန်း | |
|---|---|---|---|---|---|
| အခမဲ့ | 250,000 | — | — | $0 | အခမဲ့ Sign Up |
| စတင်သူ | 2,500,000 | $9/မတ်လ | စာရင်းသွင်းပါ | ||
| ပရို | 10,000,000 | $29/မတ်လ | စာရင်းသွင်းပါ | ||
| စီးပွားရေး | 40,000,000 | $79/မတ်လ | စာရင်းသွင်းပါ | ||
| စကေး | 125,000,000 | $199/မတ်လ | စာရင်းသွင်းပါ | ||
| Enterprise | Unlimited | $499/မတ်လ | Contact Sales |
သင်သည်သင်၏အကန့်အသတ်ကိုကျော်လွန်တဲ့အခါ, သင်သည်တစ်ဦးကိုလက်ခံရရှိပါလိမ့်မယ် 402 Payment Required နောက်တစ်လအထိတုံ့ပြန်မှုသို့မဟုတ်သင် upgrade လုပ်ပါ.
Auto-Scaling မိုးရွာသွန်းမှုအခြေခံအဆောက်အအုံ
TranslateAPI အလိုအလျောက် horizontal scaleing နှင့်အတူအထူး NVIDIA A100 GPU ဥပမာအပေါ် runs. လိုအပ်ချက်တိုးလာတဲ့အခါ, မြန်ဆန်တုံ့ပြန်မှုအချိန်ထိန်းသိမ်းရန်မိနစ်အတွင်းအပို GPU ဥပမာများစတင်. အားလုံးတောင်းဆိုမှုများကိုတန်းစီနှင့်စီမံခန့်ခွဲနေကြသည် - တပြိုင်နက်တည်းတောင်းဆိုမှုများရာပေါင်းများစွာပို့ဆောင်ခြင်းနှင့်သူတို့အားလုံးကိုင်တွယ်ပါလိမ့်မယ်။
ပိုမို Credits လိုအပ်ပါသလား?
သင့်ရဲ့အစီအစဉ်ကိုပြောင်းလဲခြင်းမရှိဘဲတစ်ကြိမ်တည်း credit ကို top-up ကိုဝယ်ယူပါ။ အပေါ်-အပိုဆောင်းပက်ကေ့ချ်များကိုကြည့်ရှု