Doiciméadú API

Comhtháthú aistriúchán cumhachtach isteach i do iarratais lenár API REST simplí.

Ag Tosú

Cuireann an TranslateAPI comhéadan simplí REST ar fáil chun téacs a aistriú idir 180+ teanga.Tugann gach críochphointe API freagraí JSON ar ais.

Bonn- URL: https://api.translateapi.ai/api/v1/
Tosaigh Mear

Déan do chéad iarratas aistriúcháin:

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!"
    }
}

Fíordheimhniú

Fíordheimhnigh d'iarratais ag baint úsáide as eochair API. Is féidir leat eochracha API a chruthú ó do painéal.

Fíordheimhniú Ceanntáisc (Molta)
Authorization: Bearer ta_your_api_key_here
Paraiméadar Iarratais
https://api.translateapi.ai/api/v1/translate/?api_key=ta_your_api_key_here
Coinnigh do chuid eochracha API slán! Ná nocht iad i gcód taobh cliaint nó stórtha poiblí.

Aistrigh Téacs

Téacs a aistriú go sprioctheanga amháin.

POST https://api.translateapi.ai/api/v1/translate/
Corp an Iarratais
Paraiméadair Cineál Riachtanach Cur Síos
text string Tá Téacs le haistriú (uasmhéid 50,000 carachtar)
target_language string Tá* Target language code (e.g., "es", "fr", "de")
source_language string @ info: status Source language code. Default: "auto" (auto-detect)

* Úsáid target_language (teaghrán) le haghaidh teanga amháin nó target_languages (eagar) le haghaidh il. Féach Aistriúchán Il- Sprioc.

Freagra
{
    "translated_text": "Hola, mundo!",
    "source_language": "en",
    "target_language": "es",
    "translations": {
        "es": "Hola, mundo!"
    },
    "character_count": 13,
    "translation_time": 0.45
}

Aistriúchán Il- Sprioc

Aistrigh téacs go teangacha éagsúla in iarratas amháin. Úsáideann an pointe deiridh céanna mar aistriúchán amháin.

Cineál: Is féidir leat aistriúchán a dhéanamh ar suas le 50 teanga in aon iarratas amháin.
POST https://api.translateapi.ai/api/v1/translate/
Corp an Iarratais
{
    "text": "Hello, world!",
    "target_languages": ["es", "fr", "de", "ja"],
    "source_language": "en"
}

Úsáid target_languages (eagar) in ionad target_language (teaghrán) le haghaidh spriocanna éagsúla.

Freagra
{
    "source_language": "en",
    "translations": {
        "es": "Hola, mundo!",
        "fr": "Bonjour, monde!",
        "de": "Hallo, Welt!",
        "ja": "こんにちは、世界！"
    },
    "character_count": 52,
    "translation_time": 2.31
}

Baisc- Aistriúchán

Aistrigh téacsanna iolracha ag an am céanna le próiseáil async. Cuir isteach baisc agus pobalbhreith le haghaidh torthaí.

Teorainneacha: uasmhéid de 500 téacs in aghaidh an bhaisc, uasmhéid de 750 mír san iomlán (téacsanna × sprioctheangacha).Tagann deireadh le jabanna 30 nóiméad tar éis tús a chur leis an bpróiseáil (ní áirítear an t-am feithimh sa scuaine).
Athraíonn an t-am próiseála de réir teanga: úsáideann teangacha coitianta (Spáinnis, Fraincis, Gearmáinis, srl.) samhlacha gasta (~0.1s in aghaidh an téacs), agus úsáideann teangacha nach bhfuil chomh coitianta lenár múnla mór ilteangach (~1-3s in aghaidh an téacs). Is gnách go gcríochnaítear baisc de 100 téacs i 10-30 soicind do theangacha coitianta, nó 2-5 nóiméad do na cinn nach bhfuil chomh coitianta. Chun na torthaí is fearr a fháil, seol sprioctheanga amháin in aghaidh an iarratais ar bhaisc agus coinnigh méid na mbaisc faoi bhun 50 téacs.
POST https://api.translateapi.ai/api/v1/translate/batch/
Céim 1: Cuir Baisc isteach
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"
}'
Freagra (HTTP 202 Glactha)
{
    "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/"
}
Céim 2: Pobalbhreith le haghaidh Torthaí
GET https://api.translateapi.ai/api/v1/jobs/{job_id}/
Sampla Pollta (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)
Freagra (ar feitheamh - ciúáilte, ag fanacht le GPU)
{
    "job_id": "67535b2b-...",
    "status": "pending",
    "processed_texts": 0,
    "total_texts": 3,
    "progress_percentage": 0.0,
    "queue_position": 3
}
Freagra (le linn próiseála)
{
    "job_id": "67535b2b-...",
    "status": "processing",
    "processed_texts": 1,
    "total_texts": 3,
    "progress_percentage": 33.33,
    "queue_position": null
}
Freagra (críochnaithe)
{
    "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
    }
}
Rianú Dul Chun Cinn Fíor- Ama

Cuimsíonn gach freagra pobalbhreithe réimsí dul chun cinn fíor-ama ionas gur féidir leat monatóireacht a dhéanamh go díreach cad atá ag tarlú le do bhaisc:

Réimse Cur Síos
status Stádas reatha an jab: pending (sa chiú, ag feitheamh le hoibrí GPU), processing (ag aistriú go gníomhach), completed, failed
processed_texts Líon na n-aistriúchán aonair críochnaithe go dtí seo. Nuashonruithe i bhfíor-am de réir mar a aistrítear gach téacs.
total_texts Líon iomlán na n-aistriúchán sa bhaisc seo (téacsanna × sprioctheangacha).
progress_percentage Céatadán críochnaithe (0-100). Ríomhtha ó próiseáilte_téacsanna / iomlán_téacsanna.
queue_position Do sheasamh sa chiú nuair atá an stádas "ar feitheamh" (1 = an chéad cheann eile). Nialasach nuair atá sé próiseáilte nó críochnaithe. Úsáid é seo chun an t- am feithimh a mheas agus stádas an chiú a thaispeáint do d' úsáideoirí.
processing_time Am próiseála iomlán i soicindí (ar fáil nuair atá sé críochnaithe).
Cineál: Nuair status is "pending", tá na hoibrithe GPU gnóthach le baisceanna eile. Seiceáil queue_position chun a fheiceáil cé mhéad post atá os comhair do phoist (1 = is tú an chéad duine eile).Tosóidh do phost go huathoibríoch — níl aon ghníomhaíocht ag teastáil, lean ort ag pobalbhreithiú.
Na Cleachtais is Fearr le haghaidh Ualach Oibre Móra
  • Seol 1 sprioctheanga in aghaidh an iarratais bhaisc. Coinníonn sé seo gach baisc go tapa agus déanann sé an dul chun cinn a rianú go héasca.
  • Coinnigh baisceanna ag 50-100 téacsanna. baisceanna níos lú a chomhlánú níos tapúla agus a thabhairt duit nuashonruithe dul chun cinn níos minice.
  • Rith ar a mhéad 2 jab comhthreomhara baisc. Próiseálann an GPU 2 bhaisc go comhthreomhar - cuireann jabanna breise ciú agus ní thosóidh siad níos tapúla.
  • Nuair a théann an t- am amach, déan pobalbhreith ar an job_ id céanna arís in ionad baisc nua a sheoladh. Seans go bhfuil an jab bunaidh á phróiseáil fós ar an LAP.
  • Pobalbhreith gach 3- 5 soicind. Ní chuireann pobalbhreith níos minice dlús leis an bpróiseáil.
Baisc Ilteangach

Aistrigh téacsanna éagsúla go teangacha éagsúla ag an am céanna:

{
    "texts": ["Hello", "Goodbye"],
    "target_languages": ["es", "fr"],
    "source_language": "en"
}
Toradh_sonraí críochnaithe
{
    "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
}
Paraiméadair Iarratais
Paraiméadair Cineál Riachtanach Cur Síos
texts array Tá Eagar na dteaghrán le haistriú
target_language string Tá* Cód sprioctheanga le haghaidh teanga aonair
target_languages array Tá* Eagar de chóid sprioctheanga d'iltheangacha
source_language string @ info: status Source language code. Default: "auto"

* Ceachtar a chur ar fáil target_language nó target_languages, ní an dá cheann.

Próiseáil Aisioncrónach: Baisc iarratais ar ais láithreach le job_id. Poll GET /api/v1/jobs/{job_id}/ go dtí status is "completed", ansin léigh result_data le haghaidh aistriúcháin. Úsáid progress_percentage chun dul chun cinn a rianú.

Aistriúchán Cáipéise

Aistrigh cáipéisí iomlána agus formáidiú á chaomhnú. Tacaíonn sé le formáidí comhaid iomadúla.

POST https://api.translateapi.ai/api/v1/translate/document/
Iarratas (sonraí ilpháirtí/foirm)
Paraiméadair Cineál Riachtanach Cur Síos
file file Tá An doiciméad le haistriú (10MB ar a mhéad)
target_language string Tá Target language code (e.g., "es", "fr", "de")
source_language string @ info: status Source language code. Default: "auto" (auto-detect)
Cineálacha Comhaid a dTacaítear Leo
  • .txt - Comhaid ghnáth- théacs
  • .docx - Cáipéisí Word
  • .pdf - Doiciméid PDF (scanta san áireamh)
  • .json - Comhaid JSON (aistríonn luachanna teaghráin)
  • .xml - Comhaid XML
  • .srt - Comhaid fhotheidil
  • .po / .pot - Comhaid aistriúcháin Gettext
  • .jpg / .jpeg - Íomhánna JPEG (OCR)
  • .png - Íomhánna PNG (OCR)
  • .tiff / .tif - Íomhánna TIFF (OCR)
  • .bmp - Íomhánna BMP (OCR)
  • .webp - Íomhánna WebP (OCR)
Tacaíocht OCR: Déantar comhaid íomhá agus PDFanna scanta a phróiseáil le haithint optúil carachtar (OCR) chun téacs a bhaint amach roimh aistriúchán.Chun na torthaí is fearr a fháil, bain úsáid as íomhánna soiléire ardtaifigh.
Sampla (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"
Déantar comhaid íomhá a phróiseáil le OCR chun téacs a bhaint roimh aistriúchán. .txt comhad.
Freagra
{
    "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"
}
Luachanna Stádais
pending Comhad uasluchtaithe, ag feitheamh le próiseáil
processing Aistriúchán ar siúl
completed Aistriúchán críochnaithe, íoslódáil ar fáil
failed Theip ar aistriúchán (check error_message)
GET https://api.translateapi.ai/api/v1/translate/document/{id}/

Seiceáil stádas aistriúcháin doiciméid nó faigh an URL íoslódála.

Freagra
{
    "id": 123,
    "original_filename": "document.docx",
    "status": "completed",
    "translated_file_url": "/media/translated/document_es.docx",
    "character_count": 5420
}

Braith Teanga

Tá braite teanga tógtha i ngach iarratas aistriúcháin. Socraigh source_language to "auto" (nó é a fhágáil ar lár) agus cuirtear an teanga a bhraitear ar ais sa fhreagra.

POST https://api.translateapi.ai/api/v1/translate/
Corp an Iarratais
{
    "text": "Bonjour, comment allez-vous?",
    "target_language": "en"
}
Freagra
{
    "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
}

An source_language Taispeánann an réimse sa fhreagra an teanga a bhraitear nuair a úsáidtear braite uathoibríoch.

Teangacha Tacaithe

Faigh liosta de na teangacha go léir a dtacaítear leo.

GET https://api.translateapi.ai/api/v1/translate/languages/
Freagra
{
    "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"},
        ...
    ]
}

Samhlacha Aistriúcháin

Bainimid úsáid as samhlacha aistriúcháin foinse oscailte úrscothacha atá ag rith ar ár mbonneagar GPU féin agus tá gach samhla ceadúnaithe go tráchtála (Apache 2.0).

Samhail Teangacha Is Fearr le haghaidh
Helsinki-NLP/opus-mt 50+ péirí teanga Teangacha coitianta (EN, ES, FR, DE, IT, PT, RU, ZH, JA, etc.)
Google MADLAD-400 400+ teangacha Teangacha annamh, clúdach cuimsitheach

Roghnóidh an API go huathoibríoch an tsamhail is fearr do do phéire teangacha. Is féidir leat rogha a shonrú engine paraiméadar:

Inneall Cur Síos
"auto" Réamhshocrú. Bain triail as HuggingFace ar dtús, titim ar ais go dtí MADLAD- 400
"huggingface" Force HuggingFace/MarianMT (an ceann is tapúla, 50+ teanga)
"madlad" Fórsa MADLAD-400 (400+ teangacha)

Láimhseáil Earráidí

Úsáideann an API cóid stádais HTTP caighdeánacha chun rath nó teip a léiriú.

Cód Cur Síos
200 Rathúil
400 Drochiarratas - Paraiméadair Neamhbhailí
401 Neamhúdaraithe - Eochair API neamhbhailí nó ar iarraidh
402 Íocaíocht Riachtanach - Sáraíodh an cuóta carachtar laethúil
429 An iomarca Iarratais - Sáraíodh an ráta teorann
503 Seirbhís ar Fáil - Inneall aistriúcháin síos go sealadach
Formáid Freagartha Earráide
{
    "error": "daily_limit_exceeded",
    "credits_remaining": 0,
    "daily_limit": 100000
}

Teorainneacha Ráta

Athraíonn teorainneacha de réir plean. Féach praghsáil le haghaidh sonraí iomlána:

Plean Carachtair/ Mí Praghas
Saor 250,000 $0 Cláraigh saor in aisce
Tosaitheoir 2,500,000 $9/míonna Liostáil
Pro 10,000,000 $29/míonna Liostáil
Gnó 40,000,000 $79/míonna Liostáil
Scála 125,000,000 $199/míonna Liostáil

Nuair a sháraíonn tú do theorainn, gheobhaidh tú 429 Too Many Requests freagra go dtí an mhí seo chugainn nó tú a uasghrádú.

Bonneagar scamall uath-scálaithe

Ritheann TranslateAPI ar chásanna tiomnaithe NVIDIA A100 GPU le scálú cothrománach uathoibríoch.Nuair a mhéadaíonn an t-éileamh, seoltar cásanna breise GPU laistigh de nóiméid chun amanna freagartha gasta a choinneáil. Ciallaíonn sé seo gur féidir lenár API iarratais chomhthreomhara beagnach gan teorainn a láimhseáil gan díghrádú — ó iarratas amháin go mílte in aghaidh an nóiméid.

Rátáil an leathanach seo
Go raibh maith agat.
/5 bunaithe ar rátálacha