Documenti

Chunguza jinsi unavyoweza kutafsiri kwa bidii maombi yako kwa kutumia mfumo wetu sahili wa RES API.

Pata Ufunguo wa Kupata Malipo Huru Sehemu za Mwisho Usanii

Kuanza

Tafsiri ya TranslatePI inaandaa tamko sahili la kutafsiri maandishi kati ya lugha 180+. MILI hurudisha miitikio ya JSON.

1. Uwe na Mtazamo Unaofaa

Andaa akaunti huru na ufanyize ufunguo wako kutoka kwenye bodi:

  1. Tia sahihi anwani yako translateapi.ai/signup
  2. Nenda Kwenye Kipande cha mbao → MILIONI
  3. Bonyeza "Mbuni API Key" na unakili ufunguo wako

Funguo huanza na ta_ Yafuatiwa na herufi 56 za hex.

Base URUL: https://api.translateapi.ai/api/v1/
2. Fanya Ombi Lako la Kwanza

Weka alama ya_API_TE kwa kutumia ufunguo kutoka kwenye bodi lako:

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!"
$ch = curl_init("https://api.translateapi.ai/api/v1/translate/");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer YOUR_API_KEY",
        "Content-Type: application/json"
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "text" => "Hello, world!",
        "target_language" => "es"
    ])
]);

$result = json_decode(curl_exec($ch), true);
echo $result["translated_text"];  // "Hola, mundo!"
payload := strings.NewReader(`{
    "text": "Hello, world!",
    "target_language": "es"
}`)

req, _ := http.NewRequest("POST", "https://api.translateapi.ai/api/v1/translate/", payload)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")

resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()

var result map[string]interface{}
json.NewDecoder(resp.Body).Decode(&result)
fmt.Println(result["translated_text"])  // "Hola, mundo!"
var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");

var content = new StringContent(
    JsonSerializer.Serialize(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 = JsonSerializer.Deserialize<JsonElement>(
    await response.Content.ReadAsStringAsync()
);
Console.WriteLine(result.GetProperty("translated_text"));  // "Hola, mundo!"
Itikio
{
    "translated_text": "Hola, mundo!",
    "source_language": "en",
    "target_language": "es",
    "translations": {
        "es": "Hola, mundo!"
    },
    "character_count": 13,
    "translation_time": 0.45
}

Kupatana

Taja maombi yako kwa kutumia ufunguo wa API. Unaweza kutengeneza funguo za API bodi.

Ufasiri wa Kichwa (Kutangazwa)
Authorization: Bearer ta_your_api_key_here
Kichwa Kikuu cha ApiKey
Authorization: ApiKey ta_your_api_key_here
Juzi ya Query Paramter
https://api.translateapi.ai/api/v1/translate/?api_key=ta_your_api_key_here
Dumisha funguo zako zikiwa salama! Usiwafunue katika mfumo wa siri wa wateja au kwenye maduka ya umma.

Tafsiri Sahihi

Kitafsiri ujumbe kwa lugha moja tu inayolengwa.

POST https://api.translateapi.ai/api/v1/translate/
Kuomba Msamaha
Penseli Aina Zahitajiwa Maelezo
text string Ndiyo Maandishi ya kutafsiri (sax herufi 50,000)
target_language string Ndiyo* Target language code (e.g., "es", "fr", "de")
source_language string Hapana Source language code. Default: "auto" (auto-detect)
engine string Hapana Injini ya tafsiri: "auto" (defrault), "ugo", au "magaidi". Mifano ya Kutafsiri.

* Matumizi target_language lugha moja au zaidi target_languages Kwa walio wengi, bila ya shaka watakuwa wengi, Tafsiri ya Lugha Mbalimbali.

Itikio
{
    "translated_text": "Hola, mundo!",
    "source_language": "en",
    "target_language": "es",
    "translations": {
        "es": "Hola, mundo!"
    },
    "character_count": 13,
    "translation_time": 0.45
}
Auto-Defection: Omit source_language au uuweke "auto" Lugha inayogunduliwa hurudishwa moja kwa moja katika lugha hiyo source_language ukajibu swali hilo.

Tafsiri ya Lugha Mbalimbali

Kitafsiri ujumbe kwa lugha mbalimbali kwa ombi moja tu.

POST https://api.translateapi.ai/api/v1/translate/
Kuomba Msamaha
{
    "text": "Hello, world!",
    "target_languages": ["es", "fr", "de", "ja"],
    "source_language": "en"
}

Matumizi target_languages (arra) badala ya target_language Kwa ajili ya malengo mbalimbali.

Itikio
{
    "source_language": "en",
    "translations": {
        "es": "Hola, mundo!",
        "fr": "Bonjour, monde!",
        "de": "Hallo, Welt!",
        "ja": "こんにちは、世界！"
    },
    "character_count": 52,
    "translation_time": 2.31
}
Dokezo: Unaweza kutafsiri lugha 50 hivi katika ombi moja.

Tafsiri ya Banch

Tengeneza maandiko mengi mara moja kwa utayarishaji wa asnic. Ogea fungu la maneno na kura kwa ajili ya matokeo.

Mipaka: Kijitabu cha Max 100 kwa kila safu, chax 300 kwa jumla (habari zinazolenga lugha).
Mwendo: Lugha za kawaida (ES, FR, DE) hutumia violezo vya kasi (50.1/ext). Lugha chache za kawaida hutumia kigezo chetu cha lugha mbalimbali (51-3/ext).
POST https://api.translateapi.ai/api/v1/translate/batch/
Hatua ya 1: Mjitiishe Chini ya Mtihani
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"
}'
Itikio (HTP 202 Yakubaliwa)
{
    "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/"
}
Hatua 2: Kuchavusha ili Kupata Matokeo
GET https://api.translateapi.ai/api/v1/jobs/{job_id}/
Kuchavusha Mfano (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"Done: {processed}/{total} in {result.get('processing_time', 0):.1f}s")
        translations = result["result_data"]["translations"]
        break
    elif status == "failed":
        raise Exception(result.get("error_message", "Translation failed"))
    elif status == "pending":
        print(f"Queued (position {result.get('queue_position', '?')})")
    else:
        print(f"[{status}] {processed}/{total} ({progress:.0f}%)")

    time.sleep(3)
Itikio (likamilishwa)
{
    "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
    }
}
Maendeleo ya Wakati Halisi
Field Maelezo
status pending Na anaye jitendea mwenyewe kheri basi bila ya shaka Mwenyezi Mungu ni Mwenye shukrani na Mjuzi. processing (tafsiri yenye utendaji), completed, failed
processed_texts Hesabu ya tafsiri moja - moja iliyokamilishwa hadi sasa.
progress_percentage Asilimia kamili (0-100). ilikadiriwa kutokana na habari zilizotayarishwa_exts / refall_exts.
queue_position Nafasi yako katika foleni wakati ambapo hadhi "inapanda" (1 = halafu).
processing_time Wakati kamili wa utengenezaji kwa sekunde chache (upatikane unapokamilika).
Batch wa Ng'ambo

Hutafsiri maandiko mbalimbali katika lugha mbalimbali mara moja:

{
    "texts": ["Hello", "Goodbye"],
    "target_languages": ["es", "fr"],
    "source_language": "en"
}
Matokeo kamili_data
{
    "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
}
Vipindi vya Kuomba Msaada
Penseli Aina Zahitajiwa Maelezo
texts array Ndiyo File ya nyuzi za kutafsiri
target_language string Ndiyo* Mfumo wa lugha unaolengwa wa lugha kwa ajili ya lugha moja
target_languages array Ndiyo* Alama za lugha zinazolengwa za lugha mbalimbali
source_language string Hapana Source language code. Default: "auto"

* Andaa ama target_language au target_languages, si vyote viwili.

Mazoea Bora kwa Ajili ya Wafanyakazi Wengi
  • Andika lugha 1 kwa kila jambo unaloomba, na hilo hufanya kila kikundi kisafiri haraka na kufanya maendeleo kwa urahisi ili kiweze kufuatilia.
  • Weka makala kwenye kurasa 50-100. Malango madogo hukamilika haraka zaidi na kukupa makala mpya za mara kwa mara zaidi.
  • Jikabidhi kazi nyingi kama vile unavyohitaji KUNGU joli zetu za magari ili kushughulikia mahitaji ya watu.
  • Baada ya muda, kazi hiyo inaweza kuendelea kufanywa tena kwenye mtandao wa GPU.
  • Kuchavusha kila sekunde 3 hadi5. kura zaidi ya mara kwa mara haiendeshi matayarisho.

Document Translation

Pakua hati nzima - nzima huku ukihifadhi muundo. Hutegemeza miundo mbalimbali ya faili.

POST https://api.translateapi.ai/api/v1/translate/document/
Maombi (sehemu/form-data)
Penseli Aina Zahitajiwa Maelezo
file file Ndiyo Hati ya kutafsiri (max 10MB)
target_language string Ndiyo Target language code (e.g., "es", "fr", "de")
source_language string Hapana Source language code. Default: "auto" (auto-detect)
Aina za Faili Zinazotegemezwa
Waraka
  • .txt - Thibitisha faili za maandishi
  • .docx - Hati za Neno
  • .pdf - Hati za PDF (kutia ndani habari iliyochunguzwa upya)
Data & Uregeshaji
  • .json - faili za JSON (zitafsiri kanuni za uzi)
  • .xml - Mafaili ya XML
  • .srt - Mafaili yaliyohifadhiwa
  • .po / .pot - Tafuta faili za kutafsiri habari
Sanamu (OCR)
  • .jpg / .jpeg - Picha za JPEG (OCR)
  • .png - PNG picha (OCR)
  • .tiff / .tif - TIFFE picha (OCR)
  • .bmp - Picha za BMP (OCR)
  • .webp - Picha za WebP (OCR)
Mfano (URL)
# 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"
Itikio
{
    "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"
}
Uungaji mkono WA OCR: Mafaili ya picha na picha ya PDF hutayarishwa kwa utambuzi wa herufi (OCR) ili kupata maandishi kabla ya kutafsiriwa. Kwa matokeo bora zaidi, tumia picha zilizo wazi, zilizo wazi.
GET https://api.translateapi.ai/api/v1/translate/document/{id}/

Chunguza tarehe ya tafsiri ya hati au pokea nakala ya tafsiri ya URL.

Viwango
pending File akiwa amepakiwa, akisubiri kutenganishwa
processing Kazi ya kutafsiri inaendelea
completed Utafsiri ukiwa kamili, pakiaji unapatikana
failed Utafsiri haukufaulu (kuondoa makosa_mesage)

Lugha Zinazoungwa Mkono

Tafuta orodha ya lugha zote zinazotegemezwa.

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

Ona Lugha Zote 186

Mifano ya Kutafsiri

Tunatumia vianzo vya kisasa vya kutafsiri vya serikali vinavyoendeshwa kwenye mfumo wetu wenyewe wa GPU.

Mfano Lugha Bora Zaidi
Helsinki-NLP/opus-mt 50+ Lugha tofauti - tofauti Lugha za kawaida (EN, ES, FR, DE, WE, PT, RU, ZH, JA, n.k.)
Google MADLAD-400 Lugha 400+ Lugha ambazo hazina maandishi mengi, na habari kamili

API huchagua kiolezo bora zaidi kwa ajili ya wenzi wa lugha yako kwa hiari. engine parameta:

Injini Maelezo
"auto" Default.Tries HugFace kwanza, hurudi MADLAD-00
"huggingface" Kikosi cha Kusambaza Habari/MarianMT (lugha imara zaidi, 50+)
"madlad" Force MADLAD-00 (lugha 2,400+)

Kushughulikia Vibaya

API hutumia kanuni za kiwango cha HTTP kuonyesha mafanikio au kushindwa.

Kanuni Maelezo
200 Mafanikio
202 Kazi iliyokubaliwa na Bradton Batch ilipangwa kwa mafanikio
400 Maombi Mabaya ya Invalid paraters (kuondoa maandishi, lugha isiyo na utegemezo, n.k.)
401 Ukosefu wa Haki - Hushindwa au Hukosekana Ufunguo wa API
402 Malipo yalihitaji mkopo wa Character uliomalizika.
403 Kituo kikuu kilichokatazwa cha IP (PPP) hakihitaji kutiwa alama au si katika orodha ya watu weupe)
503 Utumishi wa injini isiyoweza kutafsiriwa kwa urahisi
Itikio Lisilofaa Latokezwa
{
    "error": "insufficient_credits",
    "credits_remaining": 0
}

Mipaka ya Utumizi

TranslateAPI has no request rate limits. All requests are queued and processed by our auto-scaling GPU cluster. Your plan determines your monthly character allowance:

Panga Characters/Month Batch API Waraka Bei
Huru 250,000 — — $0 Fanyeni Ishara kwa Hiari
keyboard label 2,500,000 $9/mo print operation status
Project 10,000,000 $29/mo print operation status
Biashara 40,000,000 $79/mo print operation status
Magamba 125,000,000 $199/mo print operation status
Enterprise Unlimited $499/mo Contact Sales

Ukivuka mpaka wako, utapokea 402 Payment Required Jibu ni mpaka mwezi ujao au uwe mwepesi zaidi.

Muundo wa Wingu Unaosababishwa na Magari

TranslatePI inaendesha shughuli zake kwenye tovuti ya NVIDIA A100 GPU mara kwa mara ikiwa na ulalo wa mlalo wa mlalo. Wakati uhitaji unapoongezeka, matukio zaidi ya GPU huanzishwa kwa dakika chache ili kudumisha nyakati za haraka za kuitikia. Maombi yote huratibiwa na kutenganishwa na kutuma mamia ya maombi na yote yatashughulikiwa.

Je, Kuna Sababu Nyingine?

Zikimbie kwa herufi za miezi ya katikati? doua mkopo wa kwanza bila kubadili mpango wako. Angalia vifungo vya juu

Pima ukurasa huu
Asanteni kwa viwango vyenu!
/5 msingi viwango