API ஆவணமாக்கம்
எங்கள் எளிய REST API உடன் உங்கள் பயன்பாடுகளில் பலமான மொழிபெயர்ப்பை ஒருங்கிணைக்கவும்.
துவங்கு
TranslateAPI ஒரு எளிய REST இடைமுகத்தை 180+ மொழிகளுக்கு இடையே உரையை மொழிபெயர்ப்பதற்கு வழங்குகிறது. அனைத்து API முடிவு புள்ளிகளும் JSON பதில்களைத் தருகின்றன.
1. உங்கள் API விசை பெறுக
ஒரு இலவச கணக்கை உருவாக்கவும் மற்றும் உங்கள் API விசைகளை கட்டுப்பாட்டுப் பலகத்திலிருந்து உருவாக்கவும்:
- பதிவு செய் translateapi.ai/signup
- இதற்குச் செல்லவும் டேஷ்போர்டுComment → API விசை
- "API விசை உருவாக்கு" என்பதை கிளிக் செய்து உங்கள் விசை நகலெடுக்கவும்
API விசைகள் இதனுடன் துவங்குகின்றன ta_ 56 ஹெக்ஸ் எழுத்துக்கள் பின் தொடரப்படும்.
https://api.translateapi.ai/api/v1/2. உங்கள் முதல் கோரிக்கையை செய்யவும்
உங்கள் 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 விசை மூலம் உங்கள் கோரிக்கைகளை உறுதிசெய்யவும். நீங்கள் உங்கள் கணினியில் இருந்து API விசைகளை உருவாக்கலாம் கட்டுப்பாட்டுப்பலகை.
தலைப்பு உரிமம்( பரிந்துரைக்கப்படுகிறது)
Authorization: Bearer ta_your_api_key_here
ApiKey தலைப்பு
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 | ஆமாம் | மொழிபெயர்க்க வேண்டிய உரை (அதிகபட்சம் 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 | இல்லை | மொழிபெயர்ப்பு இயந்திரம்: "auto" (முன்னிருப்பு), "huggingface", அல்லது "madlad". மொழிபெயர்ப்பு மாதிரிகளை பார்க்கவும். மொழிபெயர்ப்பு மாதிரிகள். |
* பயன்படுத்து 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 அல்லது அமைக்கவும் "auto" மூல மொழியை தானாகவே கண்டுபிடிக்கவும். கண்டுபிடிக்கப்பட்ட மொழி தானாகவே திரும்பும் source_language பதில் புலத்தை உள்ளிடவும்.
பல இலக்கு மொழிபெயர்ப்பு
ஒற்றை கோரிக்கையில் பல மொழிகளுக்கு உரையை மொழிபெயர்க்கவும். ஒற்றை மொழிபெயர்ப்பாக அதே முடிவு புள்ளியை பயன்படுத்துகிறது.
POST https://api.translateapi.ai/api/v1/translate/
கோரிக்கை உடல்
{
"text": "Hello, world!",
"target_languages": ["es", "fr", "de", "ja"],
"source_language": "en"
}
பயன்படுத்து target_languages (அடுக்கு) க்கு பதிலாக target_language பல இலக்குகளுக்கான (சரம்).
பதில்
{
"source_language": "en",
"translations": {
"es": "Hola, mundo!",
"fr": "Bonjour, monde!",
"de": "Hallo, Welt!",
"ja": "こんにちは、世界!"
},
"character_count": 52,
"translation_time": 2.31
}
தொகுப்பு மொழிபெயர்ப்பு
பல உரைகளை ஒரே நேரத்தில் அசைவற்ற செயலாக்கத்துடன் மொழிபெயர்க்கவும். ஒரு தொகுப்பு மற்றும் முடிவுகளுக்கான வாக்கெடுப்பை சமர்ப்பிக்கவும்.
POST https://api.translateapi.ai/api/v1/translate/batch/
படி 1: தொகுப்பை அனுப்பு
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: முடிவுகளுக்கான வாக்குப்பதிவு
GET https://api.translateapi.ai/api/v1/jobs/{job_id}/
பாலிங் உதாரணம் (பைத்தான்)
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 |
இதுவரை நிறைவேற்றப்பட்ட தனிப்பட்ட மொழிபெயர்ப்புகளின் எண்ணிக்கை. ஒவ்வொரு உரையும் மொழிபெயர்க்கப்படும் போது உண்மையான நேரத்தில் புதுப்பிக்கப்படுகிறது. |
progress_percentage |
முடிந்த விழுக்காடு (0- 100). processed_ texts / total_ texts ல் இருந்து கணக்கிடப்பட்டது. |
queue_position |
நிலை "நிறுத்தப்பட்டுள்ளது" (1 = அடுத்தது) என்றால் வரிசையிலுள்ள உங்கள் இடம். செயலாக்கும்போது அல்லது முடிக்கும்போது புள்ளி. காத்திருக்கும் நேரம் மற்றும் வரிசை நிலையை உங்கள் பயனர்களுக்கு காட்ட இதை பயன்படுத்தவும். |
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, இரண்டும் இல்லை.
பெரிய பணிகளைச் செய்ய சிறந்த நடைமுறைகள்
- ஒரு தொகுப்பு கோரிக்கைக்கு 1 இலக்கு மொழியை அனுப்பவும். இது ஒவ்வொரு தொகுப்பையும் வேகமாக வைத்திருக்கும் மற்றும் முன்னேற்றத்தை எளிதாகத் தொடர உதவும்.
- 50- 100 உரைகளில் தொகுப்புகளை வைத்திருக்கவும். சிறிய தொகுப்புகள் விரைவாக முடிந்து, அதிக முன்னேற்ற அப்டேட்களை தரும்.
- தேவையான அளவு கூட்டு பணிகளை சமர்ப்பிக்கவும் - தேவையை கையாள எங்கள் GPU குழுமம் தானியங்கி அளவுகோல். பல நிகழ்வுகளில் பணிகள் இணையாக செயலாக்கப்படுகின்றன.
- நேரம் முடிந்தவுடன், புதிய தொகுப்பை அனுப்புவதை விட அதே வேலை_ அடையாளத்தை மீண்டும் கேட்கவும். உண்மையான வேலை இன்னும் ஜிபியுவில் செயலாக்கப்படலாம்.
- ஒவ்வொரு 3-5விநாடிகளுக்கும் ஒரு முறை கேட்கவும். அதிக நேரம் கேட்கும்போது செயல்பாடு வேகமாகாது.
ஆவண மொழிபெயர்ப்பு
முழு ஆவணத்தையும் வடிவமைப்புடன் மொழிபெயர்க்கவும். பல கோப்பு வடிவமைப்புகளை ஆதரிக்கிறது.
POST https://api.translateapi.ai/api/v1/translate/document/
கோரிக்கை (பலபகுதி/வடிவம்-தகவல்)
| அளபுரு | வகை | தேவைப்படும் | விளக்கம் |
|---|---|---|---|
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- வோர்ட் ஆவணங்கள்.pdf- PDF ஆவணங்கள் (வருடப்பட்டவை உட்பட)
தரவு & உள்ளமைவு
.json- JSON கோப்புகள் (சர மதிப்புகளை மொழிபெயர்க்கிறது).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}/
ஆவண மொழிபெயர்ப்பின் நிலையை சரிபார்க்கவும் அல்லது பதிவிறக்க வலைமனை பெறவும்.
நிலை மதிப்புகள்
pending |
கோப்பு ஏற்றப்பட்டது, செயலாக்கத்திற்காக காத்திருக்கிறது |
processing |
மொழிபெயர்ப்பு நடைபெறுகிறது |
completed |
மொழிபெயர்ப்பு முடிந்தது, பதிவிறக்கம் கிடைக்கும் |
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"},
...
]
}
மொழிபெயர்ப்பு மாதிரிகள்
நாங்கள் திறந்த மூல மொழிபெயர்ப்பு மாதிரிகளை பயன்படுத்துகிறோம். அனைத்து மாதிரிகளும் வர்த்தக ரீதியாக அனுமதிக்கப்பட்டுள்ளன (அப்பாச்சி 2.0).
| மாதிரி | மொழிகள் | சிறந்த |
|---|---|---|
| Helsinki-NLP/opus-mt | 50+ மொழி ஜோடி | பொதுவான மொழிகள் (EN, ES, FR, DE, IT, PT, RU, ZH, JA, etc.) |
| Google MADLAD-400 | 400+ மொழிகள் | அரிதான மொழிகள், விரிவான கட்டுரை |
API தானாகவே உங்கள் மொழி ஜோடிக்கு சிறந்த மாதிரியை தேர்ந்தெடுக்கிறது. நீங்கள் விருப்பப்படி ஒரு குறிப்பிடலாம் engine அளபுரு:
| இயந்திரம் | விளக்கம் |
|---|---|
"auto" |
முன்னிருப்பு. HuggingFace முதலில் முயற்சிக்கிறது, MADLAD- 400 க்கு திரும்புகிறது |
"huggingface" |
Force HuggingFace/MarianMT (வேகமானது, 50+ மொழிகள்) |
"madlad" |
Force MADLAD-400 (400+ மொழிகள்) |
பிழை கையாளுதல்
இந்த API வெற்றி அல்லது தோல்வியை குறிக்க தரமான HTTP நிலை குறியீடுகளை பயன்படுத்துகிறது.
| குறியீடு | விளக்கம் |
|---|---|
| 200 | வெற்றி |
| 202 | ஏற்றுக்கொள்ளப்பட்டது - தொகுப்பு பணி வெற்றிகரமாக வரிசைப்படுத்தப்பட்டது |
| 400 | தவறான கோரிக்கை — செல்லாத அளவுருக்கள் (இல்லாத உரை, ஆதரவு இல்லாத மொழி, போன்றவை) |
| 401 | அனுமதிக்கப்படாத - செல்லாத அல்லது காணப்படாத API விசை |
| 402 | செலுத்த வேண்டியது — எழுத்துகள் முடிந்துவிட்டன. உங்கள் திட்டத்தை மேம்படுத்தவும் அல்லது அதிகமாக வாங்கவும். |
| 403 | தடை செய்யப்பட்டது — API விசை தேவையான அளவு அல்லது IP வெள்ளை பட்டியலில் இல்லை |
| 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 | இலவச பதிவு |
| ஆரம்பம் | 2,500,000 | $9/மணிகள் | உறுப்பினராக்கு | ||
| புரொ | 10,000,000 | $29/மணிகள் | உறுப்பினராக்கு | ||
| வணிகம் | 40,000,000 | $79/மணிகள் | உறுப்பினராக்கு | ||
| அளவுகோல் | 125,000,000 | $199/மணிகள் | உறுப்பினராக்கு | ||
| Enterprise | Unlimited | $499/மணிகள் | Contact Sales |
நீங்கள் உங்கள் வரம்பு மீறும்போது, நீங்கள் ஒரு பெறுவீர்கள் 402 Payment Required அடுத்த மாதம் வரை பதில் அல்லது நீங்கள் மேம்படுத்த.
தானியங்கி அளவு மாற்ற மேக கட்டமைப்பு
TranslateAPI தானாகவே கிடைமட்ட அளவீடுகளுடன் ஒதுக்கப்பட்ட NVIDIA A100 GPU நிகழ்வுகளில் இயங்குகிறது. தேவை அதிகரிக்கும் போது, கூடுதல் GPU நிகழ்வுகள் விரைவான பதில் நேரங்களைப் பேண சில நிமிடங்களில் தொடங்கப்படும். அனைத்து கோரிக்கைகளும் வரிசையில் வைக்கப்பட்டு செயலாக்கப்படுகின்றன - நூற்றுக்கணக்கான ஒரே நேரத்தில் கோரிக்கைகளை அனுப்பவும் அவை அனைத்தும் கையாளப்படும். உண்மையான நேர மொழிபெயர்ப்புகளுக்கு முன்னுரிமை அளிக்கப்படுகிறது, பின்னணியில் தொகுப்பு பணிகள் செயல்படுத்தப்படுகின்றன.
அதிக மதிப்பெண்கள் தேவையா?
மாதத்தின் நடுவில் எழுத்துக்கள் முடிந்துவிட்டதா? உங்கள் திட்டத்தை மாற்றாமல் ஒருமுறைக்கு அதிகமாக கடன் பெறவும். மேல்-மேல் தொகுப்புகளைக் காட்டு