Dokumentácia rozhrania API

Integrujte výkonný preklad do svojich aplikácií pomocou nášho jednoduchého rozhrania REST API.

Ako začať

Rozhranie TranslateAPI poskytuje jednoduché rozhranie REST na preklad textu medzi viac ako 180 jazykmi.Všetky koncové body rozhrania API vracajú odpovede JSON.

Základná URL adresa: https://api.translateapi.ai/api/v1/
Rýchly štart

Vytvorte svoju prvú požiadavku na preklad:

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

Overenie pravosti

Môžete si vytvoriť API kľúče z vášho webového prehliadača alebo z vášho mobilného zariadenia. prístrojová doska.

Overenie hlavičky (odporúčané)
Authorization: Bearer ta_your_api_key_here
Parameter dotazu
https://api.translateapi.ai/api/v1/translate/?api_key=ta_your_api_key_here
Udržujte svoje API kľúče v bezpečí! Nevystavujte ich v kóde na strane klienta alebo vo verejných úložiskách.

Preložiť text

Preklad textu do jedného cieľového jazyka.

POST https://api.translateapi.ai/api/v1/translate/
Telo žiadosti
Parameter Typ Povinné Popis
text string Áno. Text na preklad (max. 50 000 znakov)
target_language string Áno* Target language code (e.g., "es", "fr", "de")
source_language string - Nie. Source language code. Default: "auto" (auto-detect)

* Použitie target_language (reťazec) pre jeden jazyk alebo target_languages (pole) pre viacnásobné. Pozri Preklad viacerých cieľov.

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

Preklad viacerých cieľov

Preklad textu do viacerých jazykov v jednej žiadosti.Používa rovnaký koncový bod ako jeden preklad.

Typ: Môžete preložiť až do 50 jazykov v jednej žiadosti.
POST https://api.translateapi.ai/api/v1/translate/
Telo žiadosti
{
    "text": "Hello, world!",
    "target_languages": ["es", "fr", "de", "ja"],
    "source_language": "en"
}

Použitie target_languages (pole) namiesto target_language (reťazec) pre viaceré ciele.

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

Dávkový preklad

Preklad viacerých textov naraz s asynchrónnym spracovaním. Odošlite dávku a hlasujte o výsledkoch.

Limity: max. 500 textov na dávku, max. 750 položiek celkom (texty × cieľové jazyky), časový limit úlohy 30 minút po začatí spracovania (nepočíta sa čakanie vo fronte).
Čas spracovania sa líši v závislosti od jazyka: bežné jazyky (španielčina, francúzština, nemčina atď.) používajú rýchle modely (~ 0,1 s na text), zatiaľ čo menej bežné jazyky používajú náš veľký viacjazyčný model (~ 1-3 s na text). Dávka 100 textov sa zvyčajne dokončí za 10-30 sekúnd pre bežné jazyky alebo za 2-5 minút pre menej bežné jazyky.
POST https://api.translateapi.ai/api/v1/translate/batch/
Krok 1: Odoslanie dávky
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"
}'
Odpoveď (HTTP 202 Prijaté)
{
    "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/"
}
Krok 2: Prieskum výsledkov
GET https://api.translateapi.ai/api/v1/jobs/{job_id}/
Príklad hlasovania (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)
Odpoveď (čakanie — vo fronte, čakanie na GPU)
{
    "job_id": "67535b2b-...",
    "status": "pending",
    "processed_texts": 0,
    "total_texts": 3,
    "progress_percentage": 0.0,
    "queue_position": 3
}
Odpoveď (počas spracovania)
{
    "job_id": "67535b2b-...",
    "status": "processing",
    "processed_texts": 1,
    "total_texts": 3,
    "progress_percentage": 33.33,
    "queue_position": null
}
Odpoveď (dokončená)
{
    "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
    }
}
Real-Time sledovanie pokroku

Každá odpoveď na prieskum obsahuje polia priebehu v reálnom čase, takže môžete presne sledovať, čo sa deje s dávkou:

Pole Popis
status Aktuálny stav práce: pending (vo fronte, čaká na pracovníka GPU), processing (aktívne prekladá), completed, failed
processed_texts Počet doteraz dokončených jednotlivých prekladov.Aktualizácie v reálnom čase, keď je každý text preložený.
total_texts Celkový počet prekladov v tejto dávke (texty × cieľové jazyky).
progress_percentage Percento dokončenia (0-100). Vypočítané zo spracovaných_textov / celkových_textov.
queue_position Vaša pozícia vo fronte, keď je stav "čakanie" (1 = ďalej). Null pri spracovaní alebo dokončení. Použite toto na odhad čakacej doby a zobrazenie stavu frontu vašim používateľom.
processing_time Celkový čas spracovania v sekundách (k dispozícii po dokončení).
Typ: Kedy status je "pending", pracovníci GPU sú zaneprázdnení inými dávkami. Check queue_position Vaša úloha sa spustí automaticky — nie je potrebná žiadna akcia, stačí pokračovať v hlasovaní.Your job will start automatically — no action needed, just continue voting.
Osvedčené postupy pre veľké pracovné zaťaženia
  • Odoslanie jedného cieľového jazyka na jednu dávkovú požiadavku udržuje každú dávku rýchlu a umožňuje jednoduché sledovanie pokroku.
  • Udržujte dávky na 50-100 textov.Menšie dávky dokončiť rýchlejšie a poskytnúť vám častejšie aktualizácie priebehu.
  • Grafický procesor spracúva 2 dávky paralelne – ďalšie úlohy sa ukladajú do frontu a nespúšťajú sa rýchlejšie.
  • Po uplynutí časového limitu namiesto odoslania novej dávky opätovne skontrolujte rovnaké ID úlohy Pôvodná úloha sa môže stále spracovávať na grafickom procesore.
  • Dotazovanie sa vykonáva každých 3-5 sekúnd. Častejšie dotazovanie neurýchľuje spracovanie.
Multi-jazyková dávka

Preložiť viac textov do viacerých jazykov naraz:

{
    "texts": ["Hello", "Goodbye"],
    "target_languages": ["es", "fr"],
    "source_language": "en"
}
Údaje o dokončených výsledkoch
{
    "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
}
Parametre požiadavky
Parameter Typ Povinné Popis
texts array Áno. Pole reťazcov na preklad
target_language string Áno* Kód cieľového jazyka pre jeden jazyk
target_languages array Áno* Pole kódov cieľových jazykov pre viacero jazykov
source_language string - Nie. Source language code. Default: "auto"

* Uveďte buď target_language alebo target_languages, nie oboje.

Asynchrónne spracovanie: Dávkové požiadavky sa vrátia okamžite s job_id. Diera GET /api/v1/jobs/{job_id}/ až kým status je "completed", potom prečítajte result_data Vyhľadávanie prekladov. Použitie progress_percentage Sledovať pokrok.

Preklad dokumentov do slovenčiny

Prekladajte celé dokumenty so zachovaním formátovania. Podporuje viacero formátov súborov.

POST https://api.translateapi.ai/api/v1/translate/document/
Požiadavka (viacdielna/údaje formulára)
Parameter Typ Povinné Popis
file file Áno. Dokument na preklad (max 10MB)
target_language string Áno. Target language code (e.g., "es", "fr", "de")
source_language string - Nie. Source language code. Default: "auto" (auto-detect)
Podporované typy súborov
  • .txt - Obyčajné textové súbory
  • .docx - Dokumenty programu Word
  • .pdf - Dokumenty vo formáte PDF (vrátane naskenovaných)
  • .json - JSON súbory (prekladajú reťazcové hodnoty)
  • .xml - Súbory XML
  • .srt - Súbory s titulkami
  • .po / .pot - Gettext prekladové súbory
  • .jpg / .jpeg - Obrázky JPEG (OCR)
  • .png - PNG obrázky (OCR)
  • .tiff / .tif - Obrázky TIFF (OCR)
  • .bmp - BMP obrázky (OCR)
  • .webp - WebP obrázky (OCR)
Podpora pre OCR: Obrázkové súbory a naskenované súbory PDF sa spracovávajú pomocou optického rozpoznávania znakov (OCR) na extrakciu textu pred prekladom.Na dosiahnutie najlepších výsledkov používajte jasné obrázky s vysokým rozlíšením.
Príklad (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"
Obrazové súbory sú spracované pomocou OCR na extrakciu textu pred prekladom.Preložený výstup je vrátený ako .txt súbor.
Odpoveď
{
    "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"
}
Hodnoty stavu
pending Súbor nahraný, čaká na spracovanie
processing Preklad v príprave
completed Preklad dokončený, k dispozícii na stiahnutie
failed Preklad zlyhal (check error_message)
GET https://api.translateapi.ai/api/v1/translate/document/{id}/

Skontrolujte stav prekladu dokumentu alebo získajte adresu URL na stiahnutie.

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

Detekcia jazyka

Detekcia jazyka je zabudovaná do každej požiadavky na preklad. Nastaviť source_language to "auto" (alebo ho vynechať) a zistený jazyk sa vráti v odpovedi.

POST https://api.translateapi.ai/api/v1/translate/
Telo žiadosti
{
    "text": "Bonjour, comment allez-vous?",
    "target_language": "en"
}
Odpoveď
{
    "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
}

200 mg/ deň source_language Pole v odpovedi zobrazuje zistený jazyk pri použití automatickej detekcie.

Podporované Podporované jazyky

Získajte zoznam všetkých podporovaných jazykov.

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

Modely prekladov

Používame najmodernejšie open source prekladateľské modely bežiace na našej vlastnej GPU infraštruktúre, ktoré sú komerčne licencované (Apache 2.0).

Model Jazyky Najlepšie pre
Helsinki-NLP/opus-mt Viac ako 50 jazykových párov Bežné jazyky (EN, ES, FR, DE, IT, PT, RU, ZH, JA, atď.)
Google MADLAD-400 Viac ako 400 jazykov Vzácne jazyky, komplexné pokrytie

Rozhranie API automaticky vyberie najlepší model pre vašu jazykovú dvojicu. Môžete voliteľne zadať engine Parameter:

Motor Popis
"auto" Predvolené. Najprv skúša HuggingFace, potom sa vráti späť na MADLAD-400
"huggingface" Force HuggingFace/MarianMT (najrýchlejšie, viac ako 50 jazykov)
"madlad" Force MADLAD-400 (400+ jazykov)

Manipulácia s chybami

API používa štandardné stavové kódy HTTP na označenie úspechu alebo zlyhania.

Kód Popis
200 Úspech
400 Zlá požiadavka - neplatné parametre
401 Neautorizované - Neplatný alebo chýbajúci kľúč API
402 Vyžaduje sa platba - denná kvóta znakov prekročená
429 Príliš veľa požiadaviek - prekročenie limitu rýchlosti
503 Služba je dočasne nedostupná - Translation engine temporarily down
Formát odpovede na chybu
{
    "error": "daily_limit_exceeded",
    "credits_remaining": 0,
    "daily_limit": 100000
}

Limity sadzieb

Limity sa líšia v závislosti od programu. stanovenie cien Pre úplné podrobnosti:

Plán Počet znakov/mesiac Cena
Zadarmo 250,000 $0 Zaregistrujte sa zdarma
Štartér 2,500,000 $9/mesiacov Prihlásiť sa na odber
Pre 10,000,000 $29/mesiacov Prihlásiť sa na odber
Podnikanie 40,000,000 $79/mesiacov Prihlásiť sa na odber
Stupnica 125,000,000 $199/mesiacov Prihlásiť sa na odber

Keď prekročíte svoj limit, dostanete 429 Too Many Requests Odpoveď až do budúceho mesiaca, alebo môžete inovovať.

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.

Ohodnotiť túto stránku
Ďakujeme za vaše hodnotenie!
/5 na základe hodnotenia