Pagina documentationis

Haec pagina explicat linguam quae in usu est in linguam simplex.

Comitatus

TranslateAPI simplicem REST interfacem textus inter plus quam 180 linguas traducendi praebet. Omnes puncta terminalia API responsum JSON restituunt.

URL interretialis: https://api.translateapi.ai/api/v1/
Initiatio rapida

Facit tuum primum translationis petitionem:

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

Authenticatio

Authentificere tes petitiones per claviculam API. claviculas API ex tuis scriptis creare potestas. tabula.

Authenticatio capitis (recomendata)
Authorization: Bearer ta_your_api_key_here
Parametrus query
https://api.translateapi.ai/api/v1/translate/?api_key=ta_your_api_key_here
Incolae Securienses appellantur. Non iam in usu sunt, sed in bibliothecis publicas et privatas.

Textus translatio

Textus interretialis in plurimis linguis.

POST https://api.translateapi.ai/api/v1/translate/
Corpus petitionis
Parametrus Tipus Requiescit Descriptio
text string Si Textus ad tradundum (max 50 000 caracteres)
target_language string Si * Target language code (e.g., "es", "fr", "de")
source_language string No. Source language code. Default: "auto" (auto-detect)

Utilitas target_language (string) for single language or target_languages (array) for multiple. See Pagina interretialis multilinguis.

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

Pagina interretialis multilinguis

Textum in plurimas linguas in unica petitione traduxit. Proprium punctum finem ut singularem translationem utitur.

Tipus: In plus quam 50 linguas translata est.
POST https://api.translateapi.ai/api/v1/translate/
Corpus petitionis
{
    "text": "Hello, world!",
    "target_languages": ["es", "fr", "de", "ja"],
    "source_language": "en"
}

Utilitas target_languages (array) in loco target_language (String) pro multis propositis.

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

Textus interretialis

Multis textibus simultaneo translatio async processu. Submit a batch and poll for results.

Limites: max. 500 textus per locum, max. 750 elementa totalia (textus × linguae propositae). Labores 30 minutas post processum incipiendum expirant (tempora codae non computata sunt).
Tempore processioni per linguas variat: linguae comunes (Hispanica, Francica, Germanica, etc.) modella rapida (~0.1s per textum) utuntur, dum linguae non comunes nostum modellam multilinguam (~1-3s per textum) utuntur. Locum 100 textorum typice in 10-30 secundis pro linguae comunes, vel 2-5 minutas pro loci non comunes finitur. Pro optimis resultatis, 1 linguam propositam per locum petitionem inviare et locum magnitudinem sub 50 textibus tenet.
POST https://api.translateapi.ai/api/v1/translate/batch/
Pacem 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"
}'
Pagina interretialis (HTML 2.0)
{
    "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/"
}
Gradus 2: De Eventibus Quaerere
GET https://api.translateapi.ai/api/v1/jobs/{job_id}/
Pagina interretialis (Italiane)
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)
Reactiones (pendens — in columnam vocatus, GPU attendere)
{
    "job_id": "67535b2b-...",
    "status": "pending",
    "processed_texts": 0,
    "total_texts": 3,
    "progress_percentage": 0.0,
    "queue_position": 3
}
Reactiones (durante processum)
{
    "job_id": "67535b2b-...",
    "status": "processing",
    "processed_texts": 1,
    "total_texts": 3,
    "progress_percentage": 33.33,
    "queue_position": null
}
Descriptio (Anglice)
{
    "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
    }
}
Pagina interretialis temporis realis

Quod est, omnes res quae in universo factae sunt, in hoc universo factae sunt, ut res quae in universo facta sunt factae sunt.

Terrae Descriptio
status Status hodiernus: pending (in columna, GPU operariorum attendere), processing (Actually translating), completed, failed
processed_texts Numerus individualium translationum usque ad nunc complectarum. Actualizationes in tempo reale cum hoc textus traduitur.
total_texts Numerus totalis translationum in hoc locum (textus × linguae propositae).
progress_percentage Percentage completion (0-100). Calculated from processed_texts / total_texts.
queue_position Tua positio in coda cum status est "pendens" (1 = proximus). Nullum cum processatur vel finitur. Utitur ut tempus atendis estimari et status codae utrentis tuos mostrari.
processing_time Tempore usque ad finem saeculi secundi (ab anno 2000) in usu erat.
Tipus: Quod status est "pending", GPU operarii sunt occupati cum aliis locis. Check queue_position to see how many jobs are ahead of yours (1 = you're next). Your job will start automatically — no action needed, just continue polling.
Praeterea multas operam dedit.
  • 1 linguam propositam pro petitione loci inviare. Haec locum veloce manet et progressum faciliter invenitur.
  • 50-100 textus in locis tenet. Minores loci velociter finiunt et frequentiores progressus actualizationes dant.
  • Executare maximum 2 concomitantes loci labores. GPU 2 loci parallele processit — labores adiuvante in columnam et non velociter incipiunt.
  • In temporis expiratione, re-interrogare id_opere similem in locum novae partis submissionis. Opus originalis in GPU etiam processus esse potest.
  • Interrogare omnes 3-5 secundae. Interrogationes frequentes processum non accelerant.
Multilingue

Plurima textus in plurimas linguas simultaneo tradunt:

{
    "texts": ["Hello", "Goodbye"],
    "target_languages": ["es", "fr"],
    "source_language": "en"
}
Result_data complecta
{
    "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
}
Parametra petitionis
Parametrus Tipus Requiescit Descriptio
texts array Si Array of strings to translate
target_language string Si * Index communium praefecturae Inferioris Linguae
target_languages array Si * Index communium praefecturae Finis Terrae Linguae
source_language string No. Source language code. Default: "auto"

* Provide either target_language vel target_languages, non ambo.

Pagina interretialis: Incolae Retienses vel Retienses appellantur. job_id. Hoc GET /api/v1/jobs/{job_id}/ usque status est "completed", postea legere result_data pro translationibus. progress_percentage Incolae Progressienses appellantur.

Textus interretialis

Traduit omnem documentum formattationem conservando. Multis formatis archivis sustinet.

POST https://api.translateapi.ai/api/v1/translate/document/
Descriptio (Anglice) Descriptio (Anglice)
Parametrus Tipus Requiescit Descriptio
file file Si Documentum ad tradundum (max 10MB)
target_language string Si Target language code (e.g., "es", "fr", "de")
source_language string No. Source language code. Default: "auto" (auto-detect)
Tipi archivii sustinenti
  • .txt - Textus simplex
  • .docx - Documenta Word
  • .pdf - Index communium praefecturae Scaniae (Anglice)
  • .json - JSON files (translates string values)
  • .xml - Paginae XML
  • .srt - Subtitle files
  • .po / .pot - Textus interretialis
  • .jpg / .jpeg - JPEG imago (OCR)
  • .png - Imagines PNG (OCR)
  • .tiff / .tif - Imagines TIFF (OCR)
  • .bmp - BMP imago (OCR)
  • .webp - Pagina officialis (Italiane)
OCR suportus: Files imagines et scanned PDFs sunt processatae cum Optical Character Recognition (OCR) ut textum ante translationem extraheret. For best results, use clear, high-resolution images.
(Anglice) (Francogallice)
# 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"
Image files are processed with OCR to extract text before translation. The translated output is returned as a .txt Archivum.
Repraesentationes
{
    "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"
}
Status valorum
pending File uploaded, waiting to be processed
processing Translatio in progresso
completed Pagina interretialis, cum translatione
failed Errore in translatione (verificatio error_message)
GET https://api.translateapi.ai/api/v1/translate/document/{id}/

Verificare status documenti translationis aut retrievare URL download.

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

Descriptio linguae

Detectio linguae in omnem petitionem translationis incorporatur. Set source_language to "auto" (Anglice) (Italiane) Descriptio linguae in pagina interretiali.

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

The source_language Haec pagina de linguis explicat, quae in usu sunt.

Linguae suffragatae

Obtinuit listam omnium linguarum sustinendarum.

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

Textus interretialis

Haec pagina de lingua Anglica explicat, quae in lingua Anglica scripta est.

Modellum Linguae Optima.
Helsinki-NLP/opus-mt 250 paginae interretiales Linguae communes (EN, ES, FR, DE, IT, PT, RU, ZH, JA, etc.)
Google MADLAD-400 400 linguas habet. Pagina interretialis linguae Graecae

The API automatically selects the best model for your language pair. You can optionally specify a engine Parametrus:

Motor Descriptio
"auto" Default. Trys HuggingFace first, falls back to MADLAD-400
"huggingface" 2007 - Ioannes I, papa (natus circa annum 500).
"madlad" Numerus incolarum est 400 (ab anno 2000).

Erroris manipulatio

Interretialis protocollum HTTP est protocollum interretiale quod interretialem communicare potest.

Codex Descriptio
200 Successus
400 Invalid request - invalid parameters
401 Non autorizatus - clavicula API non valida vel mancante
402 Pagamentum necesse est - Quota caeruleorum diei superata
429 Multae petitiones - limitus velocitatis superatus est
503 Service Unavailable - Translation engine temporarily down
Erroris responsus formatus
{
    "error": "daily_limit_exceeded",
    "credits_remaining": 0,
    "daily_limit": 100000
}

Incolae Limitenses appellantur.

Limites per planum variant. Praemium Descriptio interretialis:

Planum Character/Month Praemium
Liber 250,000 $0 Inscriptiones Graecas
Initium 2,500,000 $9/ms Subscribere
Pro 10,000,000 $29/ms Subscribere
Oeconomia 40,000,000 $79/ms Subscribere
Scala 125,000,000 $199/ms Subscribere

Si tu limitem excedit, tu accepit. 429 Too Many Requests Postea ad usque annum 1999 praeses factionis fuit.

Pagina officialis Infrastructurae

TranslateAPI in NVIDIA A100 GPU instanciatibus cum automatica scala horizontali operat. Cum demum crescat, GPU instanciata supplementaria in minutas initiantur ut tempores responsi veloces manent. Haec significat nostram API quae quasi infinitas concomitantes petitiones maneare potest, sine degradatione — a singulis petitionibus ad milia per minutum.

Paginae paginae
Multa gratia pro tuis commentariis!
/5 Based on Classificatio