Tahirin-kevitra

Ampidiro ao anatin'ny rindranasanao ny fandikan-teny matanjaka amin'ny alalan'ny API REST tsotra.

Fanombohana

Ny TranslateAPI dia manome mpanera REST tsotra ho an'ny fandikan-teny an-tsoratra eo amin'ny fiteny mihoatra ny 180. Manome valinteny JSON avokoa ny endpoints API rehetra.

URL fototra: https://api.translateapi.ai/api/v1/
Fandefasana haingana

Mandefa ny fangatahana fandikan-teny voalohany:

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

Fanamarinana

Ampiasao famaha API hanamarinana ny fangatahanao. Afaka mamorona famaha API avy amin'ny solosainao ianao Dashboard.

Fanamarinana ny loham-pejy (tokony atao)
Authorization: Bearer ta_your_api_key_here
Famaritana ny fangatahana
https://api.translateapi.ai/api/v1/translate/?api_key=ta_your_api_key_here
Arovy ny famaha API-nao! Aza aseho ao amin'ny rindran'asa amin'ny lafiny mpivatsy na ao amin'ny tahirin-kevitra ho an'ny daholobe izy ireo.

Dikan-teny

Adikao amin'ny teny iray ny lahabolana.

POST https://api.translateapi.ai/api/v1/translate/
Ny vatan'ilay fangatahana
Famaritana Karazana Tsy maintsy Fanoritsoritana
text string Eny Lahabolana adika (50 000 marika farafahakeliny)
target_language string Eny* Target language code (e.g., "es", "fr", "de")
source_language string Tsia Source language code. Default: "auto" (auto-detect)

* Ampiasao target_language (laha-daza) ho an'ny teny tokana na target_languages (array) ho an'ny maro. Jereo Fandikan-teny maro tanjona.

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

Fandikan-teny maro tanjona

Mandika lahabolana amin'ny teny maro amin'ny alalan'ny fangatahana tokana. Mampiasa ny farany mitovy amin'ny fandikàna tokana.

Torohevitra: Azonao atao ny mandika teny hatramin'ny 50 amin'ny fangatahana iray.
POST https://api.translateapi.ai/api/v1/translate/
Ny vatan'ilay fangatahana
{
    "text": "Hello, world!",
    "target_languages": ["es", "fr", "de", "ja"],
    "source_language": "en"
}

Ampiasao target_languages (array) fa tsy target_language (laha-daza) ho an'ny tanjona maro.

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

Fandikan-teny

Mandika lahatsoratra maro amin'ny fotoana iray amin'ny alalan'ny fiasan'ny async. Mandefa andian-dahatsoratra iray ary mifidy ny valiny.

Fetra: soratra 500 farafahakeliny isaky ny andian-dahatsoratra, 750 farafahakeliny amin'ny totalin'ny zavatra (soratra × teny iantefana). 30 minitra aorian'ny fanombohan'ny fandinihana no tapitra ny asa (tsy voaisa ny fotoana fiandrasana amin'ny filaharana).
Miovaova arakaraka ny fiteny ny fotoana fampandrosoana: mampiasa modely haingana (~0.1s isaky ny lahabolana) ny fiteny mahazatra (eoropeana, frantsay, alemana, sns.), raha mampiasa ny modely maro fiteny (~1-3s isaky ny lahabolana) kosa ny fiteny tsy dia mahazatra. Matetika dia vita ao anatin'ny 10-30 segondra ny andian-dahatsoratra 100 ho an'ny fiteny mahazatra, na 2-5 minitra ho an'ny tsy dia mahazatra. Ho an'ny vokatra tsara indrindra, mandefa teny 1 ho tanjona isaky ny fangatahana andian-dahatsoratra ary ataovy ambanin'ny 50 ny haben'ny andian-dahatsoratra.
POST https://api.translateapi.ai/api/v1/translate/batch/
Andalana 1: Alefaso ilay andian-dahatsoratra
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"
}'
Valiny (HTTP 202 ekena)
{
    "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/"
}
Dingana faha-2: Fifidianana ho an'ny vokatra
GET https://api.translateapi.ai/api/v1/jobs/{job_id}/
Ohatra amin'ny fitsapan-kevi-bahoaka (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)
Valiny (miandry — miandry ny GPU)
{
    "job_id": "67535b2b-...",
    "status": "pending",
    "processed_texts": 0,
    "total_texts": 3,
    "progress_percentage": 0.0,
    "queue_position": 3
}
Valiny (mandritra ny fandinihana)
{
    "job_id": "67535b2b-...",
    "status": "processing",
    "processed_texts": 1,
    "total_texts": 3,
    "progress_percentage": 33.33,
    "queue_position": null
}
Valiny (efa vita)
{
    "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
    }
}
Fanaraha-maso ny fivoarana amin'ny fotoana tena izy

Ny valin'ny fitsapan-kevitra tsirairay dia ahitana faritra misy ny fivoarana amin'ny fotoana tena izy mba hahafahanao manara-maso ny zava-mitranga amin'ny vondronao:

Field Fanoritsoritana
status Fivoaran'ilay asa amin'izao fotoana: pending (ao anaty filaharana, miandry mpiasa GPU), processing (midika amin'ny fomba mavitrika), completed, failed
processed_texts Isan'ny fandikan-teny tokana vita hatramin'izao. Fanavaozana amin'ny fotoana tena izy rehefa voadika ny lahatsoratra tsirairay.
total_texts Isan'ny fandikan-teny manontolo ao anatin'ity andiany ity (soratra × teny iantefana).
progress_percentage Isan-jato nahavitana (0-100). Heverina avy amin'ny processed_texts / total_texts.
queue_position Ny toerana misy anao anatin'ny filaharana raha toa ka "miandry" ny toe-draharaha (1 = manaraka). Tsy misy raha toa ka efa vita ny asa na vita. Ampiasao io hamantarana ny fotoana fiandrasana ary hanehoana ny toe-draharahan'ny filaharana amin'ny mpampiasa anao.
processing_time Ny faharetan'ny fizotra amin'ny segondra (azo ampiasaina rehefa vita).
Torohevitra: Rahoviana status dia "pending", ireo mpiasan'ny GPU dia sahirana amin'ny andiany hafa. Jereo queue_position mba hahitana hoe firy ny asa mialoha ny anao (1 = ianao no manaraka). Hatomboka hoazy ny asao — tsy mila manao na inona na inona ianao, manohy ny fitsapan-kevi-bahoaka fotsiny.
Fomba fanao tsara indrindra ho an'ny asa goavana
  • Mandefa teny tanjona 1 isaky ny fangatahana batch. Manampy amin'ny fanafainganana ny batch tsirairay izany ary manamora ny fanaraha-maso ny fivoarana.
  • Ataovy eo amin'ny 50-100 ny andian-dahatsoratra. Ny andian-dahatsoratra kely kokoa dia vita haingana kokoa ary manome anao fanavaozam-baovao matetika kokoa.
  • Mandefa asa batch 2 mifanaraka amin'izany farafahakeliny. Manatanteraka batch 2 mifanaraka amin'izany ny GPU — mifarana amin'ny filaharana ireo asa fanampiny ka tsy hanomboka haingana kokoa.
  • Rehefa tapitra ny fe-potoana, dia apetraho indray ny job_id mitovy fa tsy mandefa batch vaovao. Mety mbola miasa amin'ny GPU ihany ny asa voalohany.
  • Mandefa fanontaniana isaky ny 3-5 segondra. Tsy mampitombo ny hafainganam-pandeha ny fanontaniana miverimberina.
Loha-teny maro

Dikan-tsoratra maro amin'ny teny maro avy hatrany:

{
    "texts": ["Hello", "Goodbye"],
    "target_languages": ["es", "fr"],
    "source_language": "en"
}
Result_data vita
{
    "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
}
Famaritana ny fangatahana
Famaritana Karazana Tsy maintsy Fanoritsoritana
texts array Eny Mariky ny laha-daza hadika
target_language string Eny* Fangon'ny teny iantefana ho an'ny teny tokana
target_languages array Eny* Tobin'ny famantarana ny teny iantefana ho an'ny fiteny maro
source_language string Tsia Source language code. Default: "auto"

* Manome na target_language na target_languages, fa tsy ny roa tonta.

Fandraisana an-tànana Async: Miverina avy hatrany miaraka amin'ny job_id. Loha GET /api/v1/jobs/{job_id}/ Hatramin'ny status dia "completed", dia vakio result_data Ampiasao progress_percentage mba hanaraha-maso ny fivoarana.

Fandikana ilay tahirin-kevitra

Mandika tahirin-kevitra iray manontolo nefa mitahiry ny lamin'ny rakitra. Mandray an-tànana lamina marobe.

POST https://api.translateapi.ai/api/v1/translate/document/
Fangatahana (multipart/form-data)
Famaritana Karazana Tsy maintsy Fanoritsoritana
file file Eny Ny tahirin-kevitra hadika (10MB farafahakeliny)
target_language string Eny Target language code (e.g., "es", "fr", "de")
source_language string Tsia Source language code. Default: "auto" (auto-detect)
Karazan-drakitra raisina an-tànana
  • .txt - Raki-tsoratra tsotra
  • .docx - Tahirin-kevitra Word
  • .pdf - Tahirin-kevitra PDF (ao anatin'izany ny voasivana)
  • .json - Rakitra JSON (mandika sanda laha-daza)
  • .xml - Rakitra XML
  • .srt - Rakitry ny dikanteny
  • .po / .pot - Rakitra fandikan-teny Gettext
  • .jpg / .jpeg - Sary JPEG (OCR)
  • .png - Sary PNG (OCR)
  • .tiff / .tif - Sary TIFF (OCR)
  • .bmp - Sary BMP (OCR)
  • .webp - Sary WebP (OCR)
Fandraisana an-tànana OCR: Ireo rakitra sary sy ireo rakitra PDF voasivana dia ampiasaina amin'ny OCR (Optical Character Recognition) mba hamoahana ny lahabolana alohan'ny handikana azy. Mba hahazoana ny vokatra tsara indrindra, dia mila mampiasa sary mazava sy manana vahaolana avo ianao.
Ohatra (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"
Ireo rakitra sary dia ampiasaina amin'ny OCR mba hamoahana ny lahabolana alohan'ny fandikan-teny. Averina amin'ny endrika .txt rakitra.
Valiny
{
    "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"
}
Sandan'ny toe-draharaha
pending Nalefa ny rakitra, miandry ny fanatanterahana
processing Fandikan-teny
completed Vita ny fandikan-teny, azo alaina
failed Tsy nahomby ny fandikan-teny (jereo ny error_message)
GET https://api.translateapi.ai/api/v1/translate/document/{id}/

Mijery ny toetran'ny fandikan-teny na maka ny URL'ny fampidinana tahirin-kevitra iray.

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

Famantarana ny teny

Atao ao anatin'ny fangatahana fandikan-teny tsirairay ny famantarana ny teny. Set source_language to "auto" (na avelao tsy ho voalaza) ary averina ao anatin'ny valinteny ny teny hita.

POST https://api.translateapi.ai/api/v1/translate/
Ny vatan'ilay fangatahana
{
    "text": "Bonjour, comment allez-vous?",
    "target_language": "en"
}
Valiny
{
    "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
}

Ny source_language Mampiseho ny teny hita rehefa ampiasaina ny famantarana hoazy ity sehatr'asan'ny valinteny ity.

Teny raisina an-tànana

Maka ny lisitr'ireo teny rehetra raisina an-tànana.

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

Modelin'ny fandikàna

Mampiasa modely fandikan-teny loharano misokatra avo lenta izahay mandeha amin'ny fotodrafitrasa GPU-nay manokana. manana fahazoan-dàlana ara-barotra ny modely rehetra (Apache 2.0).

Modely Teny Ny tsara indrindra ho an'ny
Helsinki-NLP/opus-mt Fiteny mihoatra ny 50 Teny mahazatra (EN, ES, FR, DE, IT, PT, RU, ZH, JA, sns.)
Google MADLAD-400 Teny mihoatra ny 400 Teny tsy fahita firy, fandrakofana feno

Ny API dia misafidy hoazy ny modely tsara indrindra ho an'ny roroam-pitenenanao. Azonao atao ny mamaritra engine Famaritana:

Masinina Fanoritsoritana
"auto" Lasitra. Manandrana ny HuggingFace aloha, dia miverina amin'ny MADLAD-400
"huggingface" Manery ny HuggingFace/MarianMT (ho haingana indrindra, fiteny mihoatra ny 50)
"madlad" Force MADLAD-400 (teny mihoatra ny 400)

Fifehezana ny tsy fetezana

Ny API mampiasa ny fenitra HTTP status codes mba hanehoana ny fahombiazana na ny tsy fahombiazana.

Fandrindrana Fanoritsoritana
200 Fahombiazana
400 Fangatahana diso - Mpizahana tsy mitombina
401 Tsy nahazo alalana - Famaha API diso na tsy misy
402 Tsy maintsy atao ny fandoavam-bola - Nihoatra ny fetra isan'andro
429 Maro loatra ireo fangatahana - Nihoatra ny fetra ny tahan'ny fidirana
503 Tsy misy tolotra - Tsy miasa vonjimaika ny milina fandikàna teny
Lamin'ny valin'ny tsy fetezana
{
    "error": "daily_limit_exceeded",
    "credits_remaining": 0,
    "daily_limit": 100000
}

Fetra amin'ny tahan'ny

Miovaova arakaraka ny drafitra ny fetra. Jereo fividianana ho an'ny antsipirihany feno:

Fandaminana Marika/volana Haben'ny vidiny
Free 250,000 $0 Misoratra anarana maimaimpoana
Mpandefa 2,500,000 $9/ms Mandray anjara
Pro 10,000,000 $29/ms Mandray anjara
Asa 40,000,000 $79/ms Mandray anjara
Stock label 125,000,000 $199/ms Mandray anjara

Raha mihoatra ny fetrany ianao, dia hahazo 429 Too Many Requests tsy misy valiny mandra-pahatongan'ny volana ho avy na mandra-pahatongan'ny fanavaozana.

Fotodrafitrasa amin'ny rahona miova habe hoazy

Ny TranslateAPI dia mandeha amin'ny GPU NVIDIA A100 manokana miaraka amin'ny fanitarana mitsangana mandeha ho azy. Raha mitombo ny fangatahana, dia alefa ao anatin'ny minitra vitsivitsy ny GPU fanampiny mba hitazonana ny fotoana fijoroana haingana. Midika izany fa afaka mifehy fangatahana tsy voafetra tsy misy fahasimbana ny API-ntsika — manomboka amin'ny fangatahana tokana ka hatramin'ny an'arivony isan-minitra.

Mamaritra ity pejy ity
Misaotra tamin'ny lazao!
/5 mifototra amin'ny Famaritana