API စာရွက်စာတမ်း
ကျွန်ုပ်တို့၏ရိုးရှင်းသော REST API နှင့်အတူသင်၏ application များထဲသို့စွမ်းအားရှိသောဘာသာပြန်ချက်ကိုပေါင်းစပ်.
စတင်ခြင်း
The TranslateAPI providesasimple REST interface for translating text between 180+ languages. All API endpoints return JSON responses.
https://api.translateapi.ai/api/v1/
ချက်ချင်းစတင်
သင့်ရဲ့ပထမဦးဆုံးဘာသာပြန်ချက်တောင်းဆိုချက်ကိုလုပ်ပါ:
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!"
using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
using Newtonsoft.Json;
class Program
{
static async Task Main()
{
var client = new HttpClient();
client.DefaultRequestHeaders.Add(
"Authorization", "Bearer YOUR_API_KEY"
);
var content = new StringContent(
JsonConvert.SerializeObject(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 = await response.Content.ReadAsStringAsync();
var data = JsonConvert.DeserializeObject<dynamic>(result);
Console.WriteLine(data.translated_text); // "Hola, mundo!"
}
}
အတည်ပြုခြင်း
API key ကိုသုံးပြီးသင့်ရဲ့တောင်းဆိုမှုများကိုစစ်ဆေးပါ. သင်သည်သင်၏ API key ကိုဖန်တီးနိုင်ပါတယ် အညွှန်းစာမျက်နှာ.
ခေါင်းစီး အတည်ပြုခြင်း (အကြံပြု)
Authorization: Bearer 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) |
* အသုံးပြုမှု 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
}
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"Completed: {processed}/{total} texts in {result.get('processing_time', 0):.1f}s")
translations = result["result_data"]["translations"]
break
elif status == "failed":
print(f"Failed at {processed}/{total}: {result.get('error_message', 'unknown')}")
raise Exception(result.get("error_message", "Translation failed"))
elif status == "pending":
queue_pos = result.get("queue_position", "?")
print(f"Queued (position {queue_pos}) — waiting for GPU worker...")
else:
print(f"[{status}] {processed}/{total} ({progress:.0f}%)")
time.sleep(3)
တုံ့ပြန်မှု (စောင့်ဆိုင်း - တန်းစီ, GPU ကိုစောင့်ဆိုင်း)
{
"job_id": "67535b2b-...",
"status": "pending",
"processed_texts": 0,
"total_texts": 3,
"progress_percentage": 0.0,
"queue_position": 3
}
တုံ့ပြန်မှု (လုပ်ဆောင်နေစဉ်)
{
"job_id": "67535b2b-...",
"status": "processing",
"processed_texts": 1,
"total_texts": 3,
"progress_percentage": 33.33,
"queue_position": null
}
တုံ့ပြန်မှု (ပြီးစီး)
{
"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
}
}
အရှိန်အဟုန် ခြေရာခံခြင်း
သငျသညျအတိအကျသင်၏ batch နှင့်အတူဖြစ်ပျက်နေတာကိုစောင့်ကြည့်နိုင်ပါတယ်ဒါကြောင့်တစ်ဦးချင်းစီ poll တုံ့ပြန်ချက်လက်တွေ့အချိန်တိုးတက်မှုနယ်ပယ်များပါဝင်သည်:
| ဧရိယာ | ဖော်ပြချက် |
|---|---|
status |
လက်ရှိအလုပ်အခြေအနေ - pending (တန်းစီ, တစ်ဦး GPU အလုပ်သမားစောင့်ဆိုင်း), processing (တက်ကြွစွာဘာသာပြန်ဆို), completed, failed |
processed_texts |
[Error: UNIQUE constraint failed: translations_translation.textbase_id, translations_translation.language_id] |
total_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 |
စက္ကန့်အတွင်းစုစုပေါင်းစီမံခန့်ခွဲမှုအချိန် (ပြီးဆုံးတဲ့အခါရရှိနိုင်). |
status ဖြစ်သည် "pending", the GPU workers are busy with other batches. စစ်ဆေးပါ queue_position သင့်ရဲ့ရှေ့မှာအလုပ်အကိုင်ဘယ်လောက်ရှိသည်ကိုကြည့်ရှုရန် (1 = သငျသညျနောက်တစ်ကြိမ်ဖြစ်ကြ၏). သင့်ရဲ့အလုပ်အကိုင်အလိုအလျောက်စတင်ပါလိမ့်မယ် — မည်သည့်အပြုအမူလိုအပ်ပါသည်, just keep polling.
[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 စာသားများမှာအစုလိုက်အပြုံလိုက်ထား. အသေးစားအစုလိုက်အပြုံလိုက်ပိုမိုမြန်ဆန်ပြီးစီးနှင့်သင်ပိုမိုမကြာခဏတိုးတက်မှုသတင်းအချက်အလက်ပေး.
- [Error: UNIQUE constraint failed: translations_translation.textbase_id, translations_translation.language_id]
- [Error: UNIQUE constraint failed: translations_translation.textbase_id, translations_translation.language_id]
- Poll အားလုံး 3-5 စက္ကန့်. ပိုမိုမကြာခဏ polling လုပ်ငန်းစဉ်အရှိန်မမြှင့်.
ဘာသာစကားစုံ အုပ်စုလိုက်
တစ်ပြိုင်နက်တည်းဘာသာစကားများစွာသို့စာသားများစွာကိုဘာသာပြန်ဆို:
{
"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, နှစ်ဦးစလုံးမဟုတ်ပါ။
job_id. အပေါက် GET /api/v1/jobs/{job_id}/ အထိ status ဖြစ်သည် "completed", ထို့နောက်ဖတ်ပါ result_data ဘာသာပြန်ချက်များအတွက်. Use progress_percentage တိုးတက်မှုကိုခြေရာခံရန်။
စာရွက်စာတမ်း ဘာသာပြန်
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 ဘာသာပြန်ဖိုင်များ.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"
.txt ဖိုင်
တုံ့ပြန်မှု
{
"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"
}
အခြေအနေ တန်ဖိုးများ
pending |
ဖိုင်တင်ပြီး၊ စီမံရန်စောင့်နေသည် |
processing |
ဘာသာပြန်နေသည် |
completed |
ဘာသာပြန်ပြီးစီး, download လုပ်နိုင်ပါတယ် |
failed |
ဘာသာပြန်ချက်မအောင်မြင် (error_message ကိုစစ်ဆေးပါ) |
GET https://api.translateapi.ai/api/v1/translate/document/{id}/
စာရွက်စာတမ်းဘာသာပြန်ချက်၏အခြေအနေကိုစစ်ဆေးသို့မဟုတ်ဒေါင်းလုပ် URL ကိုရယူပါ။
တုံ့ပြန်မှု
{
"id": 123,
"original_filename": "document.docx",
"status": "completed",
"translated_file_url": "/media/translated/document_es.docx",
"character_count": 5420
}
ဘာသာစကား ရှာဖွေခြင်း
ဘာသာစကားရှာဖွေတွေ့ရှိမှုအားလုံးဘာသာပြန်ချက်တောင်းဆိုချက်ထဲသို့တည်ဆောက်ထားသည်. Set source_language to "auto" (သို့မဟုတ်ပယ်ချ) နှင့် detected ဘာသာစကားကိုတုံ့ပြန်မှုတွင်ပြန်လာသည်.
POST https://api.translateapi.ai/api/v1/translate/
တောင်းဆိုချက်ကိုယ်ထည်
{
"text": "Bonjour, comment allez-vous?",
"target_language": "en"
}
တုံ့ပြန်မှု
{
"translated_text": "Hello, how are you?",
"source_language": "fr",
"target_language": "en",
"translations": {
"en": "Hello, how are you?"
},
"character_count": 28,
"translation_time": 0.52
}
ဒီ source_language auto-ရှာဖွေတွေ့ရှိအသုံးပြုသောအခါတုံ့ပြန်မှုတွင် Field ကို detected ဘာသာစကားကိုပြသသည်။
ထောက်ပံ့ထားသော ဘာသာစကားများ
ထောက်ပံ့ထားသော ဘာသာစကားအားလုံး၏ စာရင်းကို ရယူပါ။
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 |
အောင်မြင်မှု |
400 |
မှားယွင်းသော တောင်းဆိုချက် - မမှန်ကန်သော parameters |
401 |
Unauthorized - မမှန်ကန်သောသို့မဟုတ်ပျောက်ဆုံး API key ကို |
402 |
ငွေပေးချေမှုလိုအပ်သည် - နေ့စဉ်စာလုံး quota ကျော်လွန် |
429 |
တောင်းဆိုမှုများ များလွန်းနေသည် - အမြန်နှုန်း အတိုင်းအတာ ကျော်လွန်သွားသည် |
503 |
ဝန်ဆောင်မှုမရရှိနိုင် - ဘာသာပြန်ချက်အင်ဂျင် ယာယီအောက် |
ချို့ယွင်းချက် တုံ့ပြန်မှု ပုံစံ
{
"error": "daily_limit_exceeded",
"credits_remaining": 0,
"daily_limit": 100000
}
အမြန်နှုန်း အတိုင်းအတာများ
ကန့်သတ်ချက်များစီမံကိန်းအားဖြင့်ကွဲပြားခြားနား. ကြည့်ပါ စျေးနှုန်းသတ်မှတ်ချက် အသေးစိတ်အချက်အလက်များအတွက်:
| အစီအစဉ် | အက္ခရာများ/လ | စျေးနှုန်း | |
|---|---|---|---|
| အခမဲ့ | 250,000 | $0 | အခမဲ့ Sign Up |
| စတင်သူ | 2,500,000 | $9/မတ်လ | စာရင်းသွင်းပါ |
| ပရို | 10,000,000 | $29/မတ်လ | စာရင်းသွင်းပါ |
| စီးပွားရေး | 40,000,000 | $79/မတ်လ | စာရင်းသွင်းပါ |
| စကေး | 125,000,000 | $199/မတ်လ | စာရင်းသွင်းပါ |
သင်သည်သင်၏အကန့်အသတ်ကိုကျော်လွန်တဲ့အခါ, သင်သည်တစ်ဦးကိုလက်ခံရရှိပါလိမ့်မယ် 429 Too Many Requests နောက်တစ်လအထိတုံ့ပြန်မှုသို့မဟုတ်သင် upgrade လုပ်ပါ.
Auto-Scaling Cloud Infrastructure
TranslateAPI runs on dedicated NVIDIA A100 GPU instances with automatic horizontal scaling. When demand increases, additional GPU instances are launched within minutes to maintain fast response times. This means our API can handle virtually unlimited concurrent requests without degradation — from a single request to thousands per minute.