Documentare API

Integrați traducerea puternică în aplicațiile dvs. cu API REST noastră simplă.

Începe

TranslateAPI oferă o simplă interfață REST pentru traducerea textului între 180+ limbi. Toate punctele finale API returnează răspunsurile JSON.

URL de bază: https://api.translateapi.ai/api/v1/
Pornire rapidă

Fă-ţi prima cerere de traducere:

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

Autentificare

Autentificați cererile folosind o cheie API. Puteți crea cheile API din dvs. tablă de bord.

Autentificare antet (recomandat)
Authorization: Bearer ta_your_api_key_here
Parametrul cercetării
https://api.translateapi.ai/api/v1/translate/?api_key=ta_your_api_key_here
Ţineţi cheile API în siguranţă! Nu le expune în codul client-side sau depozite publice.

Tradu textul

Traduce textul într-un singur limbaj ţintă.

POST https://api.translateapi.ai/api/v1/translate/
Organismul de cerere
Parametrul Tip Necesită Descriere
text string Da. Text pentru traducere (max 50.000 de caractere)
target_language string Da. Da. Target language code (e.g., "es", "fr", "de")
source_language string Nu. Source language code. Default: "auto" (auto-detect)

* Utilizare target_language (strigă) pentru limba unică sau target_languages (Arătați) pentru multiple. A se vedea Traducere multi- target.

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

Traducere multi- target

Traduceți textul în mai multe limbi într-o singură cerere. Folosește același punct final ca traducere unică.

Sfat: Puteți traduce până la 50 de limbi într-o singură cerere.
POST https://api.translateapi.ai/api/v1/translate/
Organismul de cerere
{
    "text": "Hello, world!",
    "target_languages": ["es", "fr", "de", "ja"],
    "source_language": "en"
}

Utilizare target_languages (Array) în loc de target_language (string) pentru obiective multiple.

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

Traducerea setului

Traduceți mai multe texte deodată cu prelucrarea async. Trimite un lot și sondaj pentru rezultate.

Limita: maxim 500 de texte pe lot, maxim 750 de elemente totale (texte × limbi ţintă). Timpul locurilor de muncă este de 30 de minute după începerea prelucrării (nu se numără timpul de așteptare în cola).
Timpul de prelucrare variază de limbă: limbile comune (espanie, franceză, germană, etc.) folosesc modele rapide (~0.1s pe text), în timp ce limbile mai mici folosesc modelul nostru multilingv mare (~1-3s pe text). Un lot de 100 de text se completează de obicei în 10-30 secunde pentru limbile comune, sau 2-5 minute pentru cele mai mici. Pentru cele mai bune rezultate, trimite 1 limbă ţintă pe lot și menține mărimea loturilor sub 50 de texte.
POST https://api.translateapi.ai/api/v1/translate/batch/
Pasul 1: Trimite o serie
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"
}'
Răspuns (HTTP 202 acceptat)
{
    "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/"
}
Pasul 2: Sondaj pentru rezultate
GET https://api.translateapi.ai/api/v1/jobs/{job_id}/
Exemplu de sondaj (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)
Răspuns (în funcție de – în coada, în așteptare pentru GPU)
{
    "job_id": "67535b2b-...",
    "status": "pending",
    "processed_texts": 0,
    "total_texts": 3,
    "progress_percentage": 0.0,
    "queue_position": 3
}
Răspuns (în timpul prelucrării)
{
    "job_id": "67535b2b-...",
    "status": "processing",
    "processed_texts": 1,
    "total_texts": 3,
    "progress_percentage": 33.33,
    "queue_position": null
}
Răspuns (completat)
{
    "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
    }
}
Urmărirea progresului în timp real

Fiecare răspuns al sondajelor include câmpuri de progres în timp real astfel încât să puteți monitoriza exact ceea ce se întâmplă cu lotul tău:

Câmp Descriere
status Starea curentă a job-ului: pending (în filare, în aşteptare pentru un lucrător GPU), processing (traducere activă), completed, failed
processed_texts Numărul de traduceri individuale finalizate până acum. Actualizări în timp real ca fiecare text este tradus.
total_texts Numărul total de traduceri în acest lot (texte × limbi ţintă).
progress_percentage Procentul de completare (0-100). Calculat din text_ prelucrat / text_ total.
queue_position Poziția ta în coada atunci când starea este "pentru" (1 = următoarea). Null la prelucrarea sau finalizarea. Folosește acest lucru pentru a estima timpul de așteptare și afișează starea coada utilizatorilor.
processing_time Timpul total de prelucrare în secunde (disponibil după finalizare).
Sfat: Când status este "pending", lucrătorii GPU sunt ocupaţi cu alte loturi. queue_position Pentru a vedea câte locuri de muncă sunt înaintea voastră (1 = tu eşti următorul). Treaba ta va începe automat – nici o acţiune necesară, pur şi simplu continuă sondajele.
Cele mai bune practici pentru sarcini de lucru mari
  • Trimite 1 limba țintă pe cerere de lot. Acest lucru menține fiecare lot rapid și face progrese ușor de urmărit.
  • Păstrați loturi la 50-100 de texte. Loturi mai mici completă mai repede și vă oferă mai frecvente actualizări de progres.
  • [Error: UNIQUE constraint failed: translations_translation.textbase_id, translations_translation.language_id]
  • La timp, re-poll același job_id în loc de a trimite un lot nou. Angajamentul original poate fi încă prelucrat pe GPU.
  • Sondaj la fiecare 3-5 secunde.
Serie multi- limbi

Traduceti mai multe texte la mai multe limbi de o dată:

{
    "texts": ["Hello", "Goodbye"],
    "target_languages": ["es", "fr"],
    "source_language": "en"
}
Date_ rezultate_ completate
{
    "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
}
Parametrii solicitării
Parametrul Tip Necesită Descriere
texts array Da. Array de stringuri de traducere
target_language string Da. Da. Codul limbii ţintă pentru limba unică
target_languages array Da. Da. Retragerea codurilor limbii ţintă pentru mai multe limbi
source_language string Nu. Source language code. Default: "auto"

* Asigurați fie target_language sau target_languages, nu amândoi.

Procesare async: Cereri de loturi returnează imediat cu o job_id. Sondaj GET /api/v1/jobs/{job_id}/ până la status este "completed", apoi citiți result_data pentru traduceri. Utilizare progress_percentage pentru a urmări progresul.

Traducerea documentului

Traducerea completă a documentelor în timp ce menținerea formatului. Suportează mai multe formate de fișiere.

POST https://api.translateapi.ai/api/v1/translate/document/
Cerere (multipart/form-data)
Parametrul Tip Necesită Descriere
file file Da. Documentul de traducere (max 10MB)
target_language string Da. Target language code (e.g., "es", "fr", "de")
source_language string Nu. Source language code. Default: "auto" (auto-detect)
Tipuri de fișiere suportate
  • .txt - Fișiere text simplu
  • .docx - Documente cu cuvinte
  • .pdf - Documente PDF (inclusiv scanate)
  • .json - Fișiere JSON (traduce valorile stringilor)
  • .xml - Fișiere XML
  • .srt - Fișiere de subtitrare
  • .po / .pot - Fișiere de traducere Gettext
  • .jpg / .jpeg - Imagini JPEG (OCR)
  • .png - Imagini PNG (OCR)
  • .tiff / .tif - Imagini TIFF (OCR)
  • .bmp - Imagini BMP (OCR)
  • .webp - Imagini WebP (OCR)
Suport OCR: Fișierele de imagine și PDF-urile scanate sunt procesate cu recunoașterea optică a caracterelor (OCR) pentru a extrage text înainte de traducere. Pentru cele mai bune rezultate, utilizați imagini clare, de înaltă rezoluție.
Exemplu (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"
Fișierele de imagine sunt procesate cu OCR pentru a extrage text înainte de traducere. Ieșirea tradusă este returnată ca un .txt Dosarul.
Răspuns
{
    "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"
}
Valori statutului
pending Fișier încărcat, în așteptare pentru a fi procesat
processing Traducerea în curs
completed Traducere completă, descărcare disponibilă
failed Traducerea a eșuat (check error_message)
GET https://api.translateapi.ai/api/v1/translate/document/{id}/

Verificați starea traducerii unui document sau recuperați URL-ul descărcat.

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

Detecție limbaj

Detecția limbii este construită în fiecare cerere de traducere. Set source_language to "auto" (sau omiteți-l) și limba detectată este returnată în răspuns.

POST https://api.translateapi.ai/api/v1/translate/
Organismul de cerere
{
    "text": "Bonjour, comment allez-vous?",
    "target_language": "en"
}
Răspuns
{
    "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
}

- Nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu, nu. source_language câmpul din răspuns arată limba detectată atunci când se utilizează detectarea automată.

Limbi sprijinite

Obține lista tuturor limbilor susținute.

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

Modele de traducere

Folosim modele de traducere open source de ultima generație care funcționează pe propria infrastructură GPU. Toate modelele sunt comercial licențiate (Apache 2.0).

Model Limbi Cel mai bun pentru
Helsinki-NLP/opus-mt 50+ perechi de limbaj Limbi comune (EN, ES, FR, DE, IT, PT, RU, ZH, JA, etc.)
Google MADLAD-400 Peste 400 de limbi Limbi rare, acoperire cuprinzătoare

API selectează automat cel mai bun model pentru perechea de limbi. Puteți specifica un engine parametri:

Motor Descriere
"auto" Predefinit. Tria HuggingFace primul, cade înapoi la MADLAD-400
"huggingface" Forța HuggingFace/MarianMT (mai rapid, 50+ limbi)
"madlad" Forța MADLAD-400 (400+ limbi)

Eroare de manipulare

API utilizează coduri de stare HTTP standard pentru a indica succes sau eșec.

Codul Descriere
200 Succes
400 Cerere necorespunzătoare - parametri nevalizi
401 Neautorizat - Cheia API nevalidă sau lipsă
402 Plată necesară - Cota de caracter zilnic depășită
429 Prea multe cereri - limita ratei a depășit
503 Serviciu Nedisponibil - motor de traducere temporar în jos
Format de răspuns la eroare
{
    "error": "daily_limit_exceeded",
    "credits_remaining": 0,
    "daily_limit": 100000
}

Limitele ratei

Limitele variază după plan. Prețurile pentru detalii complete:

Plan Personaje/Luna Preț
Gratuit 250,000 $0 Inscrie-te gratis
Pornitor 2,500,000 $9/mo Subscriere
Pro 10,000,000 $29/mo Subscriere
Afaceri 40,000,000 $79/mo Subscriere
Scala 125,000,000 $199/mo Subscriere

Când depăşeşti limita, vei primi o 429 Too Many Requests Răspuns până la luna următoare sau upgradezi.

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.

Ratați această pagină
Mulţumesc pentru rating!
/5 bazat pe ratinguri