Papatono API

Ka whakauru atu te whakamāoritanga kaha ki ōna taupānga ki a tātau API REST ngāwari.

Ki te whiwhi taumāmā API Whakamutunga Whakawhiwhinga

Ka tīmata

Ko te TranslateAPI e whakarato ana i tētahi whakawhitinga REST māmā mō te whakamāori i te kupu i waenganui i ngā reo 180+. Ko ngā pito whakamutunga katoa o te API e hoki ana ki ngā urupare JSON.

1. Ki te whiwhi i tōtou kī API

Ka waihanga tētahi kāri wātea, ka whakaputa i tōna kī API mai i te papatono:

  1. Ka whakaingoatia i te translateapi.ai/signup
  2. Tere ki Dashboard → Keys API
  3. Ka tirohia te "Hanga i te Papamahi API" me te tārua i tōna pātū

Ka tīmata ngā kī API ki ta_ Ka whaia e ngā tohu 56.

URL taketake: https://api.translateapi.ai/api/v1/
2. Ka mahi i tōna tono tuatahi

Ka whakakapia te YOUR_API_KEY ki te kī mai i tōna papatono:

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!"
Ka urupare
{
    "translated_text": "Hola, mundo!",
    "source_language": "en",
    "target_language": "es",
    "translations": {
        "es": "Hola, mundo!"
    },
    "character_count": 13,
    "translation_time": 0.45
}

Tuakiritanga

Whakamau i ōna tono mā te whakamahi i tētahi pātū API. Ka taea e koe te waihanga ngā pātū API mai i ōna Dashboard.

Whakamau i te tohuāhua (E whakarongotia ana)
Authorization: Bearer ta_your_api_key_here
ApiKey Header
Authorization: ApiKey ta_your_api_key_here
Pānga uiui
https://api.translateapi.ai/api/v1/translate/?api_key=ta_your_api_key_here
Kai te haumaru ōna kī API! Kāore e whakaaturia rātau i roto i te waehere taha o te kaiuru, i ngā puna tūmatanui rānei.

Ka whakamāoritia te kupu

Ka whakamāori te kupu ki tētahi reo ūnga kotahi.

POST https://api.translateapi.ai/api/v1/translate/
Ka tono te tinana
Parameter Kāhua E hiahiatia ana Whakamāramatanga
text string He Te kupu hei whakamāori (ki te 50,000 ngā pūāhua)
target_language string He* Target language code (e.g., "es", "fr", "de")
source_language string Kāore Source language code. Default: "auto" (auto-detect)
engine string Kāore Ka whakamāoritia te pūkaha whakamāoritanga: "auto" (whakahaere), "huggingface", "madlad" rānei. Tirohia ngā tauira whakamāoritanga. Kāhua whakamāoritanga.

* Ka whakamahia target_language (pūrākau) mō tētahi reo kotahi, target_languages (taupānga) mō te taumaha. Tirohia Whakamāoritanga Tūtohu-maha.

Ka urupare
{
    "translated_text": "Hola, mundo!",
    "source_language": "en",
    "target_language": "es",
    "translations": {
        "es": "Hola, mundo!"
    },
    "character_count": 13,
    "translation_time": 0.45
}
Kitenga-māori: Whakarerekē source_language Ka whakarite rānei ki "auto" kia kitea ai te reo pūtake. Ka hoki te reo i kitea ki te rārangi source_language te āpure urupare.

Whakamāoritanga Tūtohu-maha

Ka whakamāori te kupu ki ngā reo maha i roto i tētahi tono kotahi. Ka whakamahia te wāhi mutunga kotahi hei whakamāoritanga kotahi.

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

Ka whakamahia target_languages (taumaha) i te wāhi o target_language (pūrākau) mō ngā ūnga maha.

Ka urupare
{
    "source_language": "en",
    "translations": {
        "es": "Hola, mundo!",
        "fr": "Bonjour, monde!",
        "de": "Hallo, Welt!",
        "ja": "こんにちは、世界！"
    },
    "character_count": 52,
    "translation_time": 2.31
}
Kāhua: Ka taea e koe te whakamāori ki te 50 reo i roto i tētahi tono kotahi.

Ka whakamāoritia

Ka whakamāoritia ngā kupu maha i te wā kotahi me te tukanga ā-whāiti. Ka tukuna he rōpū me te pōti mō ngā hua.

Tepe: 100 ngā kupu nui rawa i ia rōpū, te nui rawa o ngā mea katoa e 300 (tuhi × reo ūnga). Ka oti te wā o ngā mahi 45 min i muri i te tīmatanga o te tukanga.
Āhua: Ko ngā reo noa (ES, FR, DE) e whakamahi ana i ngā tauira tere (~0.1s/whārangi). Ko ngā reo iti iho e whakamahi ana i tātau tauira reo maha (~1-3s/whārangi).
POST https://api.translateapi.ai/api/v1/translate/batch/
Hipanga 1: Whakahauhau i te rōpū
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"
}'
Ka whakaaetia te urupare (HTTP 202)
{
    "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/"
}
Hipanga 2: Pāpāho mō ngā hua
GET https://api.translateapi.ai/api/v1/jobs/{job_id}/
Hei tauira (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)
Ka oti te urupare (hoatu)
{
    "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
    }
}
Ka whai i te nekeneketanga o te wā tūturu
Taiwhenua Whakamāramatanga
status pending (i roto i te raupapa, e tūmanako ana mo tētahi kaimahi GPU), processing (te whakamāoritanga hohe), completed, failed
processed_texts Ko te maha o ngā whakamāoritanga takitahi kua oti tae noa ki tēnei wā. Ka whakamāoritia i te wā tūturu i te wā e whakamāoritia ana ia kupu.
progress_percentage Te ōrautanga o te oti (0-100). Kua tātaitai mai i te processed_texts / total_texts.
queue_position Ko tōna tūnga i roto i te raupapa ina "whāiti" te tūnga (1 = ki te taha). Kōaro ina mahia, ka oti rānei. Ka whakamahia tēnei hei whakatau i te wā āwhina me te whakaatu i te tūnga o te raupapa ki ōna kaimahi.
processing_time Ko te wā tukanga katoa i roto i ngā takirua (ka wātea ina oti).
Ko te rōpū reo maha

Ka whakamāoritia ngā kupu maha ki ngā reo maha i tētahi wā:

{
    "texts": ["Hello", "Goodbye"],
    "target_languages": ["es", "fr"],
    "source_language": "en"
}
Kua oti te hua_dāta
{
    "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
}
Ka tonoa ngā tohuāhua
Parameter Kāhua E hiahiatia ana Whakamāramatanga
texts array He Tautuhi o ngā aho hei whakamāori
target_language string He* Ko te waehere reo ūnga mō te reo kotahi
target_languages array He* He rangatū o ngā waehere reo ūnga mō ngā reo maha
source_language string Kāore Source language code. Default: "auto"

* Hoatu rānei target_language rānei target_languages, ehara i te rua.

Ko nga mahi pai rawa mo nga utu nui
  • Ka tukuna te reo ūnga 1 mō ia tono rōpū. Ka mau tonu tēnei i ia rōpū, ā, ka māmā te whai i te nekeneketanga.
  • E pupuri ana i ngā rōpū i te 50-100 ngā kupu. He tere ake te oti i ngā rōpū iti iho, ā, ka tuku atu ki a koe ngā whakamātautau arā atu anō.
  • Ka tukuna e koe he maha nga mahi whakarōpū e hiahiatia ana - ko tātau GPU cluster-scales hei whakahaere i te tono. Ka tuarua nga mahi i roto i nga tauira maha.
  • I te mutunga o te wā, ka tātari anō i te job_id ōrite i te wāhi o te hoatu i tētahi rōpū hōu. Ka taea tonu te tukatuka i te GPU te mahi taketake.
  • E pātai ana i ia 3-5 sekona. Kāore te pātai ā-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō-tō

Ka whakamāoritia te tuhinga

Ka whakamāoritia ngā tuhinga katoa me te pupuri i te hanga. E tautoko ana i ngā hanga pūranga maha.

POST https://api.translateapi.ai/api/v1/translate/document/
E tono ana (ngā wāhanga-maha/pūnaha-dātahi)
Parameter Kāhua E hiahiatia ana Whakamāramatanga
file file He Ko te tuhinga kia whakamāoritia (10MB nui rawa)
target_language string He Target language code (e.g., "es", "fr", "de")
source_language string Kāore Source language code. Default: "auto" (auto-detect)
Ko ngā momo pūkete kua tautokona
Ka taea te whakataki i ngā tuhinga
  • .txt - Ko ngā faila kupu pūnoa
  • .docx - Kāri Wāhi
  • .pdf - Tuakiri PDF (tae atu ki te karapa)
Ko te raraunga & Tatauranga
  • .json - Ka whakamāoritia ngā uara mekameka
  • .xml - Ko ngā faila XML
  • .srt - Ko ngā pūrākau pūāhua
  • .po / .pot - Gettext ngā faila whakamāoritanga
Kitenga (OCR)
  • .jpg / .jpeg - Kitenga JPEG (OCR)
  • .png - Kitenga PNG (OCR)
  • .tiff / .tif - Kitenga TIFF (OCR)
  • .bmp - Kitenga BMP (OCR)
  • .webp - He whakaahua WebP (OCR)
Hei tauira (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"
Ka urupare
{
    "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"
}
Whakawhiwhinga OCR: Ka tukatuka i ngā pūkete whakaahua me ngā PDF kātata me te mōhiotanga ā-waha (OCR) hei tango i te kupu i mua i te whakamāoritanga. Mō ngā hua pai rawa, ka whakamahia ngā whakaahua mārama me te rongoā tiketike.
GET https://api.translateapi.ai/api/v1/translate/document/{id}/

Ka tirotirohia te tūnga o te whakamāoritanga o tētahi tuhinga, ka whiwhi rānei i te URL whakataki.

Uara tūnga
pending Kua whakarewaina te faila, e tūmanako ana kia mahia
processing Ka haere tonu te whakamāoritanga
completed Kua oti te whakamāoritanga, e wātea ana te whakataki
failed Kua pōturi te whakamāoritanga (tirohia error_message)

Ka tautokona ngā reo

Ka whiwhi te rārangi o ngā reo katoa e tautokona ana.

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

Ka tirohia ngā reo 186 katoa

Kāhua whakamāoritanga

Ka whakamahia e tātau ngā tauira whakamāoritanga pūtake tūwhera e haere ana i runga i a tātau ake hanganga GPU. Ko ngā tauira katoa he whakaaetanga hokohoko (Apache 2.0).

Kāhua reo Ko te pai rawa mo
Helsinki-NLP/opus-mt 50+ ngā takirua reo Ko nga reo noa (EN, ES, FR, DE, IT, PT, RU, ZH, JA, etc.)
Google MADLAD-400 400+ reo Rerekē ngā reo, te taupānga whānui

Ka kōwhiria e te API te tauira pai rawa mō tōtou takirua reo. Ka taea e koe te whakapūtā i tētahi engine Huinga:

Kaikawe Whakamāramatanga
"auto" Papatono. Ka whakamātau HuggingFace tuatahi, ka hoki ki MADLAD-400
"huggingface" HuggingFace/MarianMT (te tere rawa, 50+ reo)
"madlad" Ka whakahaua a MADLAD-400 (400+ reo)

Whakahaere hapa

Ka whakamahia e te API ngā waehere tūnga HTTP paerewa hei tohu i te angitu, te pōhara rānei.

Waehere Whakamāramatanga
200 Tērā te angitu
202 Kua whakaaetia — Kua angitu te whakahua o te mahi rōpū
400 Whakatautau kino — Parameter kāore i te tika (tuhi kāore, reo kāore i tautokona, ērā atu mea).
401 Kāore i whakaaetia - Papamahi API tē tika, kua ngaro rānei
402 E hiahiatia ana te utu — Kua whakapeka ngā pūtea āhua. Whakahauhau i tōna mahere, hoko rānei i tētahi whakahauhau.
403 Kāore i whakaaetia — Kāore te pātū API i te āhua e hiahiatia ana, kāore rānei te IP i roto i te rārangi mā
503 Kāore i te wātea te ratonga ngaio ki te hunga whakamāoritanga.
Hanganga urupare hapa
{
    "error": "insufficient_credits",
    "credits_remaining": 0
}

Whakama te rohe

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:

Rārangi Huānga/Wā Ka taea te whakawātea te API Ka taea te whakataki i ngā tuhinga Ko te utu
Waihoki 250,000 — — $0 Ka tāuru i te wātea
Ka tīmata 2,500,000 $9/m Whakawhanake
Pro 10,000,000 $29/m Whakawhanake
Waihoki 40,000,000 $79/m Whakawhanake
Tauine 125,000,000 $199/m Whakawhanake
Enterprise Unlimited $499/m Contact Sales

Ina neke atu koe i tōna tepe, ka whiwhi a koe i tētahi 402 Payment Required Ka haere tonu te urupare tae noa ki te marama e whai ake nei, ka whakarewa rānei e koe.

Ka taea te whakarārangi i te pūnaha pūkaha māori

Ka haere a TranslateAPI ki ngā tauira NVIDIA A100 GPU whai tikanga me te whakawhānuitanga whakawhāiti ā-pūwhitiwhiti. Ina nui ake te tono, ka whakarewaina ngā tauira GPU tāpiri i roto i ngā minu hei pupuri i ngā wā urupare tere. Ka whakawhāititia, ka tukatuka ngā tono katoa — tuku rākau o ngā tono whakawhāiti, ā, ka whakahaeretia katoatia rātau. Ka whiwhi whakamāoritanga wā tūturu i te aroākapa, ka tukatuka ngā mahi rōpū i te papamuri.

E hiahiatia ana ētahi atu pūtea?

E puta ana i waho o ngā pūāhua i waenganui o te marama? Whakawhiwhia tētahi whakawhiwhinga ā-whā-whā me te kore huri i tōna mahere. Tirohia ngā kāwai whakatūtū

E whakawātea ana i tēnei pou
Mahalo mo ōna arotakenga!
/5 i runga i Āhuatanga