لاسوندونه

زموږ د ساده REST API سره ستاسو غوښتنلیکونو ته قوي ژباړه یوځای کړئ.

پېل کول

د TranslateAPI د 180 + ژبو ترمینځ د متن ژباړې لپاره یو ساده REST انٹرفیس چمتو کوي. ټول API پای ټکي JSON ځوابونه بیرته راځي.

: بنسټ URL 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 کیلي په کارولو سره خپل غوښتنې تصدیق کړئ. تاسو کولی شئ د API کیلي له خپل څخه جوړ کړئ څېرمه تخته.

(سپارښتنه شوې) سرۍ کرونه
Authorization: Bearer ta_your_api_key_here
څېړنې پېرامېټر
https://api.translateapi.ai/api/v1/translate/?api_key=ta_your_api_key_here
خپل API کیلي خوندي وساتئ! په مشتري اړخ کوډ يا عامه ذخيرو کې يې نه ښکاره کړي.

ليکنه ژباړل

د يوې موخې ژبې ته ليکنه ژباړې.

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)

* کارونه 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
}

ژباړه

په يو واحد غوښتنه کې څو ژبو ته متن ژباړې. په توګه د يو واحد ژباړې ورته پای ټکی کاروي.

: ډول تاسو کولی شئ په یوه غوښتنه کې تر 50 ژبو پورې ژباړئ.
POST https://api.translateapi.ai/api/v1/translate/
د غوښتنې بدن
{
    "text": "Hello, world!",
    "target_languages": ["es", "fr", "de", "ja"],
    "source_language": "en"
}

کارول target_languages د (ارې) پر ځای 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 پروسس په يو وخت کې څو متنونه ژباړې. د پایلو لپاره د يوه ډله او رايه وړاندې کړي.

حدونه: په هر ډله کې د 500 متنونو حد، د 750 مجموعي توکو حد (د متنونو × هدف ژبې). د پروسس وروسته د 30 دقیقو وروسته د کار وخت (د انتظار وخت انتظار وخت نه شمیرل کیږي).
د پروسس وخت د ژبې له مخې توپیر لري: عام ژبې (هسپانوي، فرانسوي، جرمني، او نور) د چټک ماډلونو (په هر متن کې ~ 0.1s) کاروي، پداسې حال کې چې لږ عام ژبې زموږ لوی څو ژبني ماډل کاروي (په هر متن کې ~ 1-3s). د 100 متن ډله معمولا د عامو ژبو لپاره په 10-30 ثانیو کې بشپړیږي، یا د 2-5 دقیقو لپاره لږ عام دي. د غوره پایلو لپاره، د هرې ډلې غوښتنې لپاره د 1 هدف ژبه واستوئ او د 50 متنونو لاندې د ډلو اندازه وساتئ.
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}/
(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
    }
}
د پرمختګ څارنه

د هرې نظر پوښتنې ځواب کې د ریښتیني وخت پرمختګ ساحې شاملې دي نو تاسو کولی شئ په دقیق ډول وګورئ چې ستاسو سره څه پیښیږي:

ډګر سپړاوی
status : اوسنی دنده انکړ pending (په صف کې، د GPU د کارګر تمه)، processing (په فعاله توګه ژباړه)، completed، failed
processed_texts د انفرادي ژباړې شمېر تر اوسه بشپړ. په رښتينې وخت کې د هر متن د ژباړې تازه معلومات.
total_texts په دې ډله کې د ژباړو ټول شمېر (د متنونو × موخه ژبو).
progress_percentage بشپړولو سلنه (0-100). له processed_texts / total_texts محاسبه.
queue_position .کله چې انکړ "په تمه" وي (۱ = راتلونکی پورته) په لړ کې ستاسو ځای. کله چې په بهير کې وي يا بشپړ شي صفر وي. دا د تمې د مهال اټکل کولو او خپل کارنانو ته د لړ انکړ ښودلو لپاره وکاروﺉ
processing_time په ثانيو کې د ټول پروسس وخت (شته کله چې بشپړ).
: ډول کله status دی "pending"، د GPU کارکوونکي د نورو ډلو سره بوخت دي. چک queue_position د دې لپاره چې وګورئ چې څومره دندې ستاسو مخکې دي (1 = تاسو راتلونکی یاست). ستاسو دنده به په اتوماتيک ډول پیل شي - هیڅ عمل ته اړتیا نشته، یوازې د رایې ورکولو ساتل.
د لویو کارونو لپاره غوره عملونه
  • په هر ډله غوښتنه 1 هدف ژبه واستوئ. دا هر ډله ګړندي ساتي او پرمختګ اسانه کوي.
  • په 50-100 متنونو کې ګروپونه وساتئ. کوچني ګروپونه ګړندي بشپړ کړئ او تاسو ته ډیر ځله پرمختګ تازه معلومات ورکړئ.
  • د GPU پروسې په موازي توګه د 2 ډلو پروسس کوي - اضافي دندې قطار او به ګړندي پیل نه کړي.
  • .په وخت تېرېدو، د نوې ټولګې د لېږلو پر ځای ورته دنده_پېژند بيا پوښتل. اصلي دنده کېدای شي چې لا هم په GPU کې په بهير کې وي
  • هر 3-5 ثانیو کې رایه ورکړئ. ډیره زیاته رایه ورکول د پروسس سرعت نه کوي.
ګڼ- ژبه ډله

په يو وخت کې څو ژبو ته څو متنونه ژباړې:

{
    "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. نه دواړه

: ناهممهاله بهير ډله غوښتنې بېرته سمدلاسه سره job_id. سوري GET /api/v1/jobs/{job_id}/ تر status دی "completed". بيا لوستل result_data د ژباړې لپاره. کارول progress_percentage د پرمختګ تعقیب.

لاسوند ژباړه

ژباړه ټول لاسوندونه په داسې حال کې چې د بڼه ساتلو. ملاتړ څو دوتنه بڼې.

POST https://api.translateapi.ai/api/v1/translate/document/
غوښتنه (ډېره برخه/فورم-اومتوک)
پېرامېټر ډول اړين سپړاوی
file file هو د ژباړې لاسوند (اکثر 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
  • .jpg / .jpeg - انځورونه JPEG (OCR)
  • .png - انځورونه PNG (OCR)
  • .tiff / .tif - انځورونه TIFF (OCR)
  • .bmp - انځورونه BMP (OCR)
  • .webp - انځورونه WebP (OCR)
: OCR ملاتړ د انځور دوتنې او سکین شوي PDFs د ژباړې دمخه د متن استخراجولو لپاره د نظری کرکټرونو پیژندلو (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"
د انځور دوتنې د OCR سره پروسس کیږي چې د ژباړې څخه مخکې متن استخراج کړي. د ژباړل شوي محصول په توګه راستون کیږي .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 ژباړه بشپړه شوه، رالېښنه شته
failed ژباړه پاتې راغله (د تېروتنې استوزه وګورﺉ)
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
}

ژبې پېژندنه

د ژبې کشف په هر ژباړې غوښتنه کې جوړ شوی. source_language to "auto" (یا پرېښودل) او کشف شوې ژبه په ځواب کې بیرته راځي.

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 په ځواب ډګر د کشف ژبه ښيي کله چې د اتومات کشف کارول کیږي.

منل شوې ژبې

د ټولو ملاتړو ژبو لړ ترلاسه کړئ.

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"},
        ...
    ]
}

ژباړې نمونې

موږ د دولت-of-the-art خلاص سرچینه د ژباړې ماډلونه زموږ په خپل GPU زیربنا چلوي کاروي. ټول ماډلونه دي په تجارتي ډول جواز (Apache 2.0).

بېلګه ژبې لپاره غوره
Helsinki-NLP/opus-mt 50+ ژبه جوړه عام ژبې (EN، ES، FR، DE، IT، PT، RU، ZH، JA، او نور)
Google MADLAD-400 400+ ژبې نادرې ژبې، پراخه پوښښ

د API په اتوماتيک ډول ستاسو د ژبې د جوړو لپاره غوره ماډل غوره کوي. تاسو کولای شي په اختياري توګه د engine : پېرمېټر

انجن سپړاوی
"auto" تلواله. لومړی HuggingFace هڅه کوي، MADLAD-400 ته بیرته راځي
"huggingface" ځواک HuggingFace / MarianMT (ژر، 50+ ژبو)
"madlad" ځواک MADLAD-400 (400+ ژبو)

تېروتنه سمبالونه

د API معياري HTTP حالت کوډونه کاروي چې د بریالیتوب یا ناکامي وښيي.

کوډ سپړاوی
200 بریالیتوب
400 ناسم غوښتنه - ناسم پېرامې
401 نه منل شوی - ناسم يا ورک API کيلۍ
402 تادیه اړینه ده - د ورځني کرکټر کوټه زياته شوه
429 ډېرې غوښتنې - د کچې حد زيات شو
503 خدمت نه شته - د ژباړې انجن لنډمهاله ښکته
د تېروتنې ځواب بڼه
{
    "error": "daily_limit_exceeded",
    "credits_remaining": 0,
    "daily_limit": 100000
}

د کچې حدونه

د پلان له مخې محدودیتونه توپیر لري. وګورئ نرخونه د بشپړو معلوماتو لپاره:

پلان لوښه/مياشت نرخ
وړیا 250,000 $0 په وړیا ډول راجستر شئ
پېلونکی 2,500,000 $9/مياشتې غړیتوب
پرو 10,000,000 $29/مياشتې غړیتوب
سوداګري 40,000,000 $79/مياشتې غړیتوب
کچول 125,000,000 $199/مياشتې غړیتوب

کله چې تاسو د خپل حد څخه زیات، تاسو به د ترلاسه کړي 429 Too Many Requests ځواب تر راتلونکې میاشتې یا تاسو د لوړولو.

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.

دا مخ کچول
ستاسو د درجه مننه!
/5 پر بنسټ کچونه