ឯកសារ API
បញ្ចូលការបកប្រែមានឥទ្ធិពលទៅក្នុងកម្មវិធីរបស់អ្នកជាមួយ REST API សាមញ្ញរបស់យើង។
ការចាប់ផ្ដើម
TranslateAPI ផ្តល់នូវចំណុចប្រទាក់ REST សាមញ្ញសម្រាប់បកប្រែអត្ថបទរវាង 180+ ភាសា។ ចំណុចបញ្ចប់ API ទាំងអស់ត្រឡប់ការឆ្លើយតប JSON ។
1. Get Your API Key
Create a free account and generate your API key from the dashboard:
- Sign up at translateapi.ai/signup
- Go to បន្ទះឧបករណ៍ → កូនសោ API
- Click "Create API Key" and copy your key
API keys start with ta_ followed by 56 hex characters.
https://api.translateapi.ai/api/v1/2. Make Your First Request
Replace YOUR_API_KEY with the key from your dashboard:
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 ។ អ្នកអាចបង្កើតកូនសោ API ពីរបស់អ្នក បន្ទះឧបករណ៍.
ការផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវបឋមកថា (បានផ្ដល់អនុសាសន៍)
Authorization: Bearer ta_your_api_key_here
ApiKey Header
Authorization: ApiKey ta_your_api_key_here
ប៉ារ៉ាម៉ែត្រសំណួរ
https://api.translateapi.ai/api/v1/translate/?api_key=ta_your_api_key_here
បកប្រែអត្ថបទ
បកប្រែអត្ថបទទៅជាភាសាគោលដៅតែមួយ & # 160; ។
POST https://api.translateapi.ai/api/v1/translate/
តួសំណើ
| ប៉ារ៉ាម៉ែត្រ | ប្រភេទ | ត្រូវការ | ការពិពណ៌នា |
|---|---|---|---|
text |
string | បាទ/ ចាស | អត្ថបទត្រូវបកប្រែ (អតិបរមា ៥០. ០០០ តួអក្សរ) |
target_language |
string | បាទ/ ចាស* | Target language code (e.g., "es", "fr", "de") |
source_language |
string | គ្មាន | Source language code. Default: "auto" (auto-detect) |
engine |
string | គ្មាន | Translation engine: "auto" (default), "huggingface", or "madlad". See Translation Models. ម៉ូដែលបកប្រែ. |
* ប្រើ target_language (ខ្សែអក្សរ) សម្រាប់ភាសាតែមួយ ឬ target_languages (អ័ក្ស) សម្រាប់ច្រើន ។ មើល ការបកប្រែគោលដៅច្រើន.
ការឆ្លើយតប
{
"translated_text": "Hola, mundo!",
"source_language": "en",
"target_language": "es",
"translations": {
"es": "Hola, mundo!"
},
"character_count": 13,
"translation_time": 0.45
}
source_language or set it to "auto" to automatically detect the source language. The detected language is returned in the source_language response field.
ការបកប្រែគោលដៅច្រើន
បកប្រែអត្ថបទទៅជាភាសាច្រើនក្នុងសំណើតែមួយ & # 160; ។ ប្រើចំណុចបញ្ចប់ដូចគ្នាជាការបកប្រែតែមួយ & # 160; ។
POST https://api.translateapi.ai/api/v1/translate/
តួសំណើ
{
"text": "Hello, world!",
"target_languages": ["es", "fr", "de", "ja"],
"source_language": "en"
}
ប្រើ target_languages (អ័ក្ស) ជំនួសឲ្យ target_language (ខ្សែអក្សរ) សម្រាប់គោលដៅច្រើន & # 160; ។
ការឆ្លើយតប
{
"source_language": "en",
"translations": {
"es": "Hola, mundo!",
"fr": "Bonjour, monde!",
"de": "Hallo, Welt!",
"ja": "こんにちは、世界!"
},
"character_count": 52,
"translation_time": 2.31
}
ការបកប្រែបាច់
បកប្រែអត្ថបទច្រើនក្នុងពេលតែមួយជាមួយនឹងការដំណើរការ async & # 160; ។ ដាក់ស្នើ batch និងការស្ទង់មតិសម្រាប់លទ្ធផល & # 160; ។
POST https://api.translateapi.ai/api/v1/translate/batch/
ជំហានទី ១ & # 160; ៖ ដាក់ស្នើបាច់
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/"
}
ជំហានទី ២ & # 160; ៖ បោះឆ្នោតរកលទ្ធផល
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
}
}
Real-Time Progress Tracking
| Field | ការពិពណ៌នា |
|---|---|
status |
pending (queued, waiting for a GPU worker), processing (actively translating), completed, failed |
processed_texts |
Number of individual translations completed so far. Updates in real time as each text is translated. |
progress_percentage |
Completion percentage (0-100). Calculated from processed_texts / total_texts. |
queue_position |
Your position in the queue when status is "pending" (1 = next up). Null when processing or completed. Use this to estimate wait time and show queue status to your users. |
processing_time |
Total processing time in seconds (available when completed). |
បាច់ភាសាច្រើន
បកប្រែអត្ថបទច្រើនទៅជាភាសាច្រើនក្នុងពេលតែមួយ & # 160; ៖
{
"texts": ["Hello", "Goodbye"],
"target_languages": ["es", "fr"],
"source_language": "en"
}
ទិន្នន័យលទ្ធផលដែលបានបញ្ចប់
{
"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, មិនទាំងពីរ & # 160; ។
Best Practices for Large Workloads
- Send 1 target language per batch request. This keeps each batch fast and makes progress easy to track.
- Keep batches at 50-100 texts. Smaller batches complete faster and give you more frequent progress updates.
- Submit as many batch jobs as you need — our GPU cluster auto-scales to handle demand. Jobs are processed in parallel across multiple instances.
- On timeout, re-poll the same job_id instead of submitting a new batch. The original job may still be processing on the GPU.
- Poll every 3-5 seconds. More frequent polling does not speed up processing.
ការបកប្រែឯកសារ
បកប្រែឯកសារទាំងមូលក្នុងពេលរក្សាទ្រង់ទ្រាយ & # 160; ។ គាំទ្រទ្រង់ទ្រាយឯកសារច្រើន & # 160; ។
POST https://api.translateapi.ai/api/v1/translate/document/
សំណើ (ផ្នែកច្រើន/ ទិន្នន័យសំណុំបែបបទ)
| ប៉ារ៉ាម៉ែត្រ | ប្រភេទ | ត្រូវការ | ការពិពណ៌នា |
|---|---|---|---|
file |
file | បាទ/ ចាស | ឯកសារត្រូវបកប្រែ (អតិបរមា ១០ មេកាបៃ) |
target_language |
string | បាទ/ ចាស | Target language code (e.g., "es", "fr", "de") |
source_language |
string | គ្មាន | Source language code. Default: "auto" (auto-detect) |
ប្រភេទឯកសារដែលគាំទ្រ
Documents
.txt- ឯកសារអត្ថបទធម្មតា.docx- ឯកសារ Word.pdf- ឯកសារ PDF (រួមទាំងឯកសារដែលបានស្កេន)
Data & Localization
.json- ឯកសារ JSON (បកប្រែតម្លៃខ្សែអក្សរ).xml- ឯកសារ XML.srt- ឯកសារចំណងជើងរង.po/.pot- ឯកសារបកប្រែ Gettext
Images (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 & # 160; ។
តម្លៃស្ថានភាព
pending |
បានផ្ទុកឯកសារឡើង រង់ចាំដំណើរការ |
processing |
ការបកប្រែកំពុងដំណើរការ |
completed |
បានបញ្ចប់ការបកប្រែ អាចទាញយកបាន |
failed |
ការបកប្រែបានបរាជ័យ (ពិនិត្យសារកំហុស) |
ភាសាដែលគាំទ្រ
យកបញ្ជីភាសាដែលបានគាំទ្រទាំងអស់ & # 160; ។
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"},
...
]
}
Submit Corrections
Suggest a better translation for a given source text. Corrections enter a moderation queue; once approved by our team they surface as "Community Verified" translations for that text.
https://translateapi.ai/api/v1/ (not the api. translation host), and requires an API key.POST https://translateapi.ai/api/v1/suggestions/
តួសំណើ
| Parameter | ប្រភេទ | ការពិពណ៌នា |
|---|---|---|
source_text |
string | The original text that was translated. |
source_language |
string | Source language code (e.g. "en"). |
target_language |
string | Target language code (e.g. "es"). |
machine_translation |
string | The machine translation you are correcting. |
suggested_translation |
string | Your improved translation (must differ from machine_translation). |
Example Request
curl -X POST https://translateapi.ai/api/v1/suggestions/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"source_text": "Hello, world!",
"source_language": "en",
"target_language": "es",
"machine_translation": "Hola, mundo!",
"suggested_translation": "¡Hola, mundo!"
}'
ការឆ្លើយតប
{
"id": 4213,
"status": "pending",
"created": true,
"message": "Correction submitted for review."
}
Re-submitting the same source/language pair updates your existing suggestion instead of creating a duplicate (returns 200 with "created": false).
ម៉ូដែលបកប្រែ
យើងប្រើម៉ូដែលបកប្រែប្រភពបើកចំហដែលដំណើរការលើហេដ្ឋារចនាសម្ព័ន្ធ GPU របស់យើងផ្ទាល់ ។ ម៉ូដែលទាំងអស់មានអាជ្ញាប័ណ្ណពាណិជ្ជកម្ម (Apache 2.0) ។
| ម៉ូដែល | ភាសា | ល្អបំផុតសម្រាប់ |
|---|---|---|
| Helsinki-NLP/opus-mt | 50+ គូភាសា | ភាសាទូទៅ (EN, ES, FR, DE, IT, PT, RU, ZH, JA, ល) |
| Google MADLAD-400 | 400+ ភាសា | ភាសាកម្រ ការគ្របដណ្តប់ទូលំទូលាយ |
API ជ្រើសម៉ូដែលល្អបំផុតសម្រាប់គូភាសារបស់អ្នកដោយស្វ័យប្រវត្តិ & # 160; ។ អ្នកអាចបញ្ជាក់ជាជម្រើស engine ប៉ារ៉ាម៉ែត្រ & # 160; ៖
| ម៉ាស៊ីន | ការពិពណ៌នា |
|---|---|
"auto" |
លំនាំដើម & # 160; ។ ព្យាយាម HuggingFace ដំបូង ធ្លាក់ត្រឡប់ទៅ MADLAD- 400 |
"huggingface" |
បង្ខំ HuggingFace / MarianMT (លឿនបំផុត, 50+ ភាសា) |
"madlad" |
កម្លាំង MADLAD-400 (400+ ភាសា) |
ការដោះស្រាយកំហុស
API ប្រើកូដស្ថានភាព HTTP ស្តង់ដារដើម្បីបង្ហាញជោគជ័យ ឬបរាជ័យ & # 160; ។
| កូដ | ការពិពណ៌នា |
|---|---|
| 200 | បរាជ័យ |
| 202 | Accepted — Batch job queued successfully |
| 400 | Bad Request — Invalid parameters (missing text, unsupported language, etc.) |
| 401 | មិនបានអនុញ្ញាត - សោ API មិនត្រឹមត្រូវ ឬបាត់ |
| 402 | Payment Required — Character credits exhausted. Upgrade your plan or purchase a top-up. |
| 403 | Forbidden — API key lacks required scope or IP not in whitelist |
| 503 | សេវាមិនអាចប្រើបាន - ម៉ាស៊ីនបកប្រែបានបិទបណ្ដោះអាសន្ន |
ទ្រង់ទ្រាយការឆ្លើយតបកំហុស
{
"error": "insufficient_credits",
"credits_remaining": 0
}
Usage Limits
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:
| ផែនការ | តួអក្សរ/ ខែ | Batch API | Documents | តម្លៃ | |
|---|---|---|---|---|---|
| ទំនេរ | 250,000 | — | — | $0 | ចុះឈ្មោះដោយឥតគិតថ្លៃ |
| កម្មវិធីចាប់ផ្ដើម | 2,500,000 | $9/ខែ | ជាវជាប្រចាំ | ||
| ជំនាញ | 10,000,000 | $29/ខែ | ជាវជាប្រចាំ | ||
| ជំនួញ | 40,000,000 | $79/ខែ | ជាវជាប្រចាំ | ||
| ធ្វើមាត្រដ្ឋាន | 125,000,000 | $199/ខែ | ជាវជាប្រចាំ | ||
| Enterprise | Unlimited | $499/ខែ | Contact Sales |
ពេលអ្នកលើសដែនកំណត់របស់អ្នក អ្នកនឹងទទួលបាន 402 Payment Required ការឆ្លើយតបរហូតដល់ខែបន្ទាប់ ឬអ្នកធ្វើឲ្យប្រសើរ & # 160; ។
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. All requests are queued and processed — send hundreds of concurrent requests and they'll all be handled. Real-time translations get priority, batch jobs process in the background.
Need More Credits?
Run out of characters mid-month? Purchase a one-time credit top-up without changing your plan. View top-up packs