Ka palapala API

Hoʻohui i ka hoʻololi ikaika i kāu mau noi me kā mākou REST API maʻalahi.

E hoʻomaka ana

ʻO ka TranslateAPI e hāʻawi ana i kahi interface REST maʻalahi no ka hoʻololi ʻana i nā huaʻōlelo ma waena o nā ʻōlelo 180+.

URL kumu: https://api.translateapi.ai/api/v1/
Hoʻomaka wikiwiki

E hana i kou noi unuhi mua:

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

Ka hoʻomanaʻo

E hōʻoia i kāu noi e hoʻohana ana i kahi kī API. Hiki iā ʻoe ke hana i nā kī API mai kāu Dashboard.

Hōʻoiaʻiʻo Hōʻailona (Hoʻohanohano)
Authorization: Bearer ta_your_api_key_here
Parameter Query
https://api.translateapi.ai/api/v1/translate/?api_key=ta_your_api_key_here
E mālama i kāu mau kī API palekana! ʻAʻole e hōʻike iā lākou i ke kānāwai client-side a i ʻole nā ​​ʻaoʻao lehulehu.

Hoʻololi i ka hua'ōlelo

Hoʻololi i ka hua'ōlelo i loko o kahi'ōlelo kikokikona.

POST https://api.translateapi.ai/api/v1/translate/
Ke kino o ka noi
Parameter ʻAno Pono Ka wehewehe ʻana
text string ʻAe Ka hua'ōlelo e hoʻohuli (max 50,000 characters)
target_language string ʻAe* Target language code (e.g., "es", "fr", "de")
source_language string ʻAʻole Source language code. Default: "auto" (auto-detect)

Hoʻohana target_language (string) no ka'ōlelo wale nō a iʻole target_languages (array) no ka nui. E nānā Multi-Target Translation.

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

Multi-Target Translation

Hoʻohuli i ka hua'ōlelo i nā'ōlelo he nui i loko o kahi noi hoʻokahi. Hoʻohana i ka hopena like e like me ka hoʻohuli hoʻokahi.

Lūkini: Hiki iā ʻoe ke hoʻohuli i nā ʻōlelo he 50 i kahi noi hoʻokahi.
POST https://api.translateapi.ai/api/v1/translate/
Ke kino o ka noi
{
    "text": "Hello, world!",
    "target_languages": ["es", "fr", "de", "ja"],
    "source_language": "en"
}

Hoʻohana target_languages (array) e like me target_language (string) no nā pahuhopu he nui.

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

Hoʻololi

Hoʻohuli i nā hua'ōlelo he nui i kahi manawa me ka hoʻoili async. E hoʻouna i kahi pūʻulu a me ka hoʻokolohua no nā hopena.

Nā palena: max 500 mau hua'ōlelo i kēlā me kēia pūʻulu, max 750 mau mea āpau (nā hua'ōlelo × nā'ōlelo pahuhopu). Nā hana i ka manawa 30 mau minuke ma hope o ka hoʻomaka o ka hoʻoponopono (ʻaʻole i helu ʻia ka manawa hoʻāʻo).
Hoʻololi ka manawa hoʻoponopono e like me ka ʻōlelo: nā ʻōlelo maʻamau (Spanish, French, German, a pēlā aku) e hoʻohana i nā ʻano wikiwiki (~ 0.1s i kēlā me kēia huaʻōlelo), a ʻo nā ʻōlelo ʻē aʻe e hoʻohana i kā mākou ʻano nui multilingual (~ 1-3s i kēlā me kēia huaʻōlelo). ʻO ka 100-text batch maʻamau e hoʻopau i 10-30 mau kekona no nā ʻōlelo maʻamau, a i ʻole 2-5 mau minuke no nā ʻōlelo ʻē aʻe. No nā hopena maikaʻi loa, e hoʻouna i ka 1 target language per batch request and keep batch sizes under 50 texts.
POST https://api.translateapi.ai/api/v1/translate/batch/
KaʻAnuʻu 1: E hoʻouna i ka pūʻulu
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"
}'
Hoʻohou (HTTP 202 Accepted)
{
    "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/"
}
KaʻAnuʻu 2: Poll no nā hopena
GET https://api.translateapi.ai/api/v1/jobs/{job_id}/
Polling Example (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)
Hoʻohou (hoʻomanaʻo — i ka huila, e noho ana no GPU)
{
    "job_id": "67535b2b-...",
    "status": "pending",
    "processed_texts": 0,
    "total_texts": 3,
    "progress_percentage": 0.0,
    "queue_position": 3
}
Ka pane (i ka wā e hoʻouna ana)
{
    "job_id": "67535b2b-...",
    "status": "processing",
    "processed_texts": 1,
    "total_texts": 3,
    "progress_percentage": 33.33,
    "queue_position": null
}
Hoʻohuli (hoʻopau)
{
    "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
    }
}
Hoʻohuli i ka holomua o ka manawa maoli

ʻO kēlā me kēia pane hoʻokolohua e hoʻopili ana i nā wahi o ka holomua o ka manawa maoli no laila hiki iā ʻoe ke nānā pono i ka mea e hana nei me kāu pūʻulu:

Pae Ka wehewehe ʻana
status Ka hana o kēia manawa: pending (hoʻokuʻu ʻia, e noho ana no kahi limahana GPU), processing (hoʻololi hoʻololi), completed, failed
processed_texts Nā helu o nā hoʻololi pono'ī i hoʻopau ʻia i kēia manawa. Hoʻohou i ka manawa maoli e like me ka hoʻololi ʻia o kēlā me kēia hua'ōlelo.
total_texts Ka nui o nā hoʻololi i kēia pūʻulu (nā hua'ōlelo × nā hua'ōlelo pahu).
progress_percentage Kekona hoʻokō (0-100). Hoʻololi mai processed_texts / total_texts.
queue_position ʻO kāu wahi i ka huila inā he "waiho" ka ʻano (1 = hope loa). Null inā hoʻokō ʻia a i ʻole hoʻopau ʻia. Hoʻohana i kēia e hoʻāʻo i ka manawa hoʻāʻo a hōʻike i ka ʻano huila i kāu mea hoʻohana.
processing_time Ka manawa hoʻokō pūʻulu i nā kekona (a hiki ke loaʻa ma hope o ka pau ʻana).
Lūkini: Ka manawa status he "pending", nā limahana GPU e hana pū ana me nā pūʻulu ʻē aʻe. Check queue_position e ʻike i ka nui o nā hana i mua o kou (1 = ʻoe ka hope). E hoʻomaka ʻia kāu hana i ka manawa like — ʻaʻohe hana e pono ai, e hoʻomau wale i ka polling.
Nā hana maikaʻi loa no nā hana nui
  • E hoʻouna i ka'ōlelo pahuhopu 1 i kēlā me kēia noi pūʻulu. Hoʻomanaʻo kēia i kēlā me kēia pūʻulu wikiwiki a maʻalahi hoʻi e hoʻokō i ka holomua.
  • E mālama i nā pūʻulu ma nā hua'ōlelo 50-100. ʻO nā pūʻulu liʻiliʻi e hoʻopau i ka wikiwiki a hāʻawi iā ʻoe i nā hoʻohou hoʻokō hou aku.
  • Hoʻokō i ka nui loa o nā hana pūʻulu 2. Hoʻokō ka GPU i nā hana pūʻulu 2 i ka manawa like — nā hana ʻē aʻe e hoʻāʻo a ʻaʻole e hoʻomaka wikiwiki.
  • I ka pauʻana o ka manawa, e ho'āʻo hou i ka job_id like me ka ho'āʻoʻana e hoʻouna i kahi pūʻulu hou. Hiki ke ho'āʻoʻia ka hana kumu ma ka GPU.
  • Poll i kēlā me kēia 3-5 mau kekona. ʻAʻole hoʻonui ka polling i ka wikiwiki o ka hana.
Multi-Language Batch

Hoʻololi i nā hua'ōlelo he nui i nā ʻōlelo he nui i ka manawa like:

{
    "texts": ["Hello", "Goodbye"],
    "target_languages": ["es", "fr"],
    "source_language": "en"
}
Hoʻopau i ka data_result
{
    "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
}
Nā hua'ōlelo noi
Parameter ʻAno Pono Ka wehewehe ʻana
texts array ʻAe Hoʻololi i nā hualoaʻa
target_language string ʻAe* Koho i kahi kānāwai'ōlelo no ka'ōlelo hoʻokahi
target_languages array ʻAe* Hoʻonohonoho o nā kānāwai'ōlelo'ōlelo no nā'ōlelo he nui
source_language string ʻAʻole Source language code. Default: "auto"

* E hāʻawi paha target_language aiʻole target_languages, ʻaʻole nāʻelua.

Async Processing: E hoʻihoʻi koke i nā noi pūʻulu me kahi job_id. Hoʻopā GET /api/v1/jobs/{job_id}/ a hiki i status he "completed", a laila heluhelu result_data no nā unuhi. Hoʻohana progress_percentage e nānā i ka holomua.

Hoʻololi i ka palapala

Hoʻololi i nā palapala a pau me ka mālama ʻana i ka hoʻohālike. E kākoʻo i nā ʻano faila he nui.

POST https://api.translateapi.ai/api/v1/translate/document/
Ka noi (multipart/form-data)
Parameter ʻAno Pono Ka wehewehe ʻana
file file ʻAe Ka palapala e hoʻololi (max 10MB)
target_language string ʻAe Target language code (e.g., "es", "fr", "de")
source_language string ʻAʻole Source language code. Default: "auto" (auto-detect)
Nā ʻano faila i kākoʻo ʻia
  • .txt - Nā faila hua'ōlelo maʻamau
  • .docx - Nā hōʻike Word
  • .pdf - Nā palapala PDF (e like me ka scanned)
  • .json - Nā faila JSON (hoʻololi i nā kumukūʻai hualoaʻa)
  • .xml - Nā faila XML
  • .srt - Nā faila hua'ōlelo
  • .po / .pot - Gettext nā faila hoʻololi
  • .jpg / .jpeg - Nā kiʻi JPEG (OCR)
  • .png - Nā kiʻi PNG (OCR)
  • .tiff / .tif - Nā kiʻi TIFF (OCR)
  • .bmp - Nā kiʻi BMP (OCR)
  • .webp - Nā kiʻi WebP (OCR)
kākoʻo OCR: Hoʻokō ʻia nā faila kiʻi a me nā PDF scanned me ka ʻike ʻana i nā huaʻōlelo optic (OCR) e hoʻokaʻawale i ka huaʻōlelo ma mua o ka hoʻololi ʻana. No nā hopena maikaʻi loa, e hoʻohana i nā kiʻi hoʻonā kiʻekiʻe.
Hōʻike (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"
Hoʻokōʻia nā faila kiʻi me OCR e hoʻokaʻawale i ka hua'ōlelo ma mua o ka hoʻololi. Hoʻihoʻiʻia ka hua'ōlelo i hoʻololiʻia ma keʻano he .txt ka faila.
Ka pane
{
    "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"
}
Nā Waihoʻoluʻu
pending Hoʻouka ʻia ka faile, e noho ana e hoʻouna ʻia
processing Hoʻololi i ka hua'ōlelo
completed Hoʻokō ʻia ka unuhi, loaʻa ka hoʻoiho
failed Haʻalele ka unuhi (hoʻāʻo error_message)
GET https://api.translateapi.ai/api/v1/translate/document/{id}/

E nānā i ke kūlana o ka hoʻololi ʻana i ka palapala a i ʻole e kiʻi i ka URL hoʻoiho.

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

Ka Hōʻikeʻana i ka'Ōlelo

Hoʻokumu ʻia ka hōʻike ʻana i ka ʻōlelo i kēlā me kēia noi hoʻololi. Hoʻonohonoho source_language to "auto" (a i ʻole hoʻokuʻu iā ia) a hoʻihoʻi ʻia ka ʻōlelo i ʻike ʻia i ka pane.

POST https://api.translateapi.ai/api/v1/translate/
Ke kino o ka noi
{
    "text": "Bonjour, comment allez-vous?",
    "target_language": "en"
}
Ka pane
{
    "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
}

Ka source_language ka papa i loko o ka pane e hōʻike ana i ka'ōlelo i ʻike ʻia ke hoʻohana ʻia ka ʻike hoʻohālike.

Nā'ōlelo i kākoʻoʻia

E kiʻi i ka papa inoa o nā'ōlelo a pau i kākoʻoʻia.

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

Pākuʻi

Hoʻohana mākou i nā ʻano hoʻololi ʻike ʻia e hoʻokō ana i kā mākou pono hana GPU ponoʻī. ʻO nā ʻano āpau he laikini kūʻai aku (Apache 2.0).

Moʻo ʻO nā ʻōlelo maikaʻi loa no
Helsinki-NLP/opus-mt 50+ mau'ōlelo Nā ʻōlelo maʻamau (EN, ES, FR, DE, IT, PT, RU, ZH, JA, a pēlā aku.)
Google MADLAD-400 400+ nā ʻōlelo ʻO nā ʻōlelo haʻahaʻa, ka hoʻopaʻa piha

ʻO ka API e koho i ka hōʻailona maikaʻi loa no kāu hui ʻōlelo. Hiki iā ʻoe ke hoʻonohonoho i kahi engine Parameter:

Ka mea hana Ka wehewehe ʻana
"auto" Paʻa. E hoʻāʻo i HuggingFace mua, e hoʻi i MADLAD-400
"huggingface" Force HuggingFace/MarianMT (ʻoi aku ka wikiwiki, 50+ mau'ōlelo)
"madlad" Force MADLAD-400 (400+ nā ʻōlelo)

Hoʻoponopono hewa

Hoʻohana ka API i nā kānāwai kūlana HTTP maʻamau e hōʻike i ka lanakila a i ʻole ka nalowale.

Kōkua Ka wehewehe ʻana
200 Hoʻomaikaʻi
400 Haʻalele i ka noi
401 ʻAʻole i hoʻopaʻa inoa ʻia - ʻAʻole maikaʻi a i ʻole he kī API ʻole
402 E pono ka uku - Hoʻokau ʻia ka helu helu o nā mea kiko'ī i kēlā me kēia lā
429 He nui loa nā noi - ʻoi aku ka palena o ka wikiwiki
503 Service Unavailable - Translation engine temporarily down
Ka hoʻohālike pane hewa
{
    "error": "daily_limit_exceeded",
    "credits_remaining": 0,
    "daily_limit": 100000
}

Ka helu moʻohelu

Hoʻololi nā palena e ka papahana. E ʻike nā kumukūʻai no nā kiko'ī piha:

Hoʻolālā Hōʻailona/ mahina Kūlana
Hoʻolaha 250,000 $0 E hoʻopaʻa inoa
Hoʻomaka 2,500,000 $9/no Hoʻopaʻa inoa
Pro 10,000,000 $29/no Hoʻopaʻa inoa
ʻOihana 40,000,000 $79/no Hoʻopaʻa inoa
Scale 125,000,000 $199/no Hoʻopaʻa inoa

Inā ʻoe e ʻoi aku i kāu palena, e loaʻa iā ʻoe 429 Too Many Requests ka pane a hiki i ka mahina e hiki mai ana a i ʻole e hoʻomaikaʻi ʻoe.

Hoʻolālā Kūlana Kūlana Kūlana Kūlana

TranslateAPI hana ma ka hoʻolauleʻa NVIDIA A100 GPU hihia me ka hoʻohālike hoʻohālike hoʻohālike. Inā nui ka noi, nā hihia GPU hou i hoʻomaka i loko o nā minuke e mālama i ka manawa pane wikiwiki.

Waiho i kēia pou
Mahalo no kou manaʻo!
/5 Hoʻokumu ʻia ma Hoʻohālike