@ action

The TranslateAPI provides a simple REST interface for translating text between 180+ languages. All API endpoints return JSON responses.

1. Get Your API Key

Create a free account and generate your API key from the dashboard:

Sign up at translateapi.ai/signup
Go to Dashboard → Maɓallan API
Click "Create API Key" and copy your key

API keys start with ta_ followed by 56 hex characters.

URL na farko: https://api.translateapi.ai/api/v1/

2. Make Your First Request

Replace YOUR_API_KEY with the key from your dashboard:

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

Mawallafi

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

QFileDialog

Ka tabbatar da bukatunka ta amfani da maɓallin API. Za ka iya ƙirƙirar maɓallan API daga cikinka Dashboard.

QFileDialog

Authorization: Bearer ta_your_api_key_here

ApiKey Header

Authorization: ApiKey ta_your_api_key_here

@ action

https://api.translateapi.ai/api/v1/translate/?api_key=ta_your_api_key_here

@ action Kada ka bayyana su a cikin lissafin uwar garke na uwar garke ko a cikin ajiyar jama'a.

@ action

POST https://api.translateapi.ai/api/v1/translate/

QDialogButtonBox

Parameters	@ action	QDialogButtonBox	Bayani
`text`	string	A' a	@ label: textbox
`target_language`	string	Na'am	Target language code (e.g., "es", "fr", "de")
`source_language`	string	QFileDialog	Source language code. Default: "auto" (auto-detect)
`engine`	string	QFileDialog	Translation engine: "auto" (default), "huggingface", or "madlad". See Translation Models. QFontDatabase.

@ action target_language (harshe) ga harshe guda ko target_languages (array) for multiple. See QFontDatabase.

Mawallafi

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

Auto-Detection: Omit source_language or set it to "auto" to automatically detect the source language. The detected language is returned in the source_language response field.

QFontDatabase

@ action: inmenu

POST https://api.translateapi.ai/api/v1/translate/

QDialogButtonBox

{
    "text": "Hello, world!",
    "target_languages": ["es", "fr", "de", "ja"],
    "source_language": "en"
}

@ action target_languages (array) a matsayin target_language (harshe) ga manyan fayiloli da yawa.

Mawallafi

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

Nau'i: Za ka iya fassara zuwa har zuwa harsuna 50 a cikin wata tambaya guda.

QPrintPreviewDialog

@ action

Limits: Max 100 texts per batch, max 300 total items (texts × target languages). Jobs time out 45 minutes after processing starts.

Speed: Common languages (ES, FR, DE) use fast models (~0.1s/text). Less common languages use our multilingual model (~1-3s/text).

POST https://api.translateapi.ai/api/v1/translate/batch/

@ action

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

QDialogButtonBox

{
    "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/"
}

QDialogButtonBox

GET https://api.translateapi.ai/api/v1/jobs/{job_id}/

QDialogButtonBox

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)

Mawallafi

{
    "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 Progress Tracking

Field	Bayani
`status`	`pending` (queued, waiting for a GPU worker), `processing` (actively translating), `completed`, `failed`
`processed_texts`	Number of individual translations completed so far. Updates in real time as each text is translated.
`progress_percentage`	Completion percentage (0-100). Calculated from processed_texts / total_texts.
`queue_position`	Your position in the queue when status is "pending" (1 = next up). Null when processing or completed. Use this to estimate wait time and show queue status to your users.
`processing_time`	Total processing time in seconds (available when completed).

@ item Spelling dictionary

@ action

{
    "texts": ["Hello", "Goodbye"],
    "target_languages": ["es", "fr"],
    "source_language": "en"
}

An kammala sakamakon_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
}

Parameters na tambaya

Parameters	@ action	QDialogButtonBox	Bayani
`texts`	array	A' a	Array na jigogi da za'a fassara
`target_language`	string	Na'am	Ƙididdigar harshe na manufa ga harshe guda
`target_languages`	array	Na'am	Array of target language codes for multiple languages
`source_language`	string	QFileDialog	Source language code. Default: "auto"

@ info: status target_language ko target_languagesÃ'a, duka biyun.

Best Practices for Large Workloads

Send 1 target language per batch request. This keeps each batch fast and makes progress easy to track.
Keep batches at 50-100 texts. Smaller batches complete faster and give you more frequent progress updates.
Submit as many batch jobs as you need — our GPU cluster auto-scales to handle demand. Jobs are processed in parallel across multiple instances.
On timeout, re-poll the same job_id instead of submitting a new batch. The original job may still be processing on the GPU.
Poll every 3-5 seconds. More frequent polling does not speed up processing.

@ action

POST https://api.translateapi.ai/api/v1/translate/document/

Tambaya (multipart/form-data)

Parameters	@ action	QDialogButtonBox	Bayani
`file`	file	A' a	Takardar da za'a fassara (maksimal 10MB)
`target_language`	string	A' a	Target language code (e.g., "es", "fr", "de")
`source_language`	string	QFileDialog	Source language code. Default: "auto" (auto-detect)

Nau'in Fayil da Aka Goyi Bayansu

Documents

.txt - Fayil na rubutu mai sauƙi
.docx - Takardun Word
.pdf - Takardun PDF (ciki har da waɗanda aka yi gwaji)

Data & Localization

.json - Files JSON (translates string values)
.xml - Files XML
.srt - Fayilolin sunaye na ƙarshe
.po / .pot - @ action

Images (OCR)

.jpg / .jpeg - Zane-Zane
.png - Zane-Zane
.tiff / .tif - Zane-Zane
.bmp - Zane-Zane
.webp - Zane-Zane WebP (OCR)

Misali (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"

Mawallafi

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

KCharselect unicode block name An yi amfani da fayilolin hotuna da PDFan da aka yi gwaji da su da na'ura mai gane alamomin gani (OCR) domin fitar da rubutu kafin fassara. Don mafi kyawun sakamako, yi amfani da hotunan da ke da inganci mai girma.

GET https://api.translateapi.ai/api/v1/translate/document/{id}/

QDialogButtonBox

Kimar Hali

`pending`	An shigar da fayil, ana jiran a aiwatar da shi
`processing`	@ info: status
`completed`	@ info: status
`failed`	QDialogButtonBox

Yaren da ake goyon baya

Ka karɓi jerin dukkan harsuna da ake goyon baya.

GET https://api.translateapi.ai/api/v1/translate/languages/

Mawallafi

{
    "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"},
        ...
    ]
}

View All 186 Languages

Submit Corrections

Suggest a better translation for a given source text. Corrections enter a moderation queue; once approved by our team they surface as "Community Verified" translations for that text.

Note: this endpoint is served from the main domain https://translateapi.ai/api/v1/ (not the api. translation host), and requires an API key.

POST https://translateapi.ai/api/v1/suggestions/

QDialogButtonBox

Parameter	@ action	Bayani
`source_text`	string	The original text that was translated.
`source_language`	string	Source language code (e.g. "en").
`target_language`	string	Target language code (e.g. "es").
`machine_translation`	string	The machine translation you are correcting.
`suggested_translation`	string	Your improved translation (must differ from machine_translation).

Example Request

curl -X POST https://translateapi.ai/api/v1/suggestions/ \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
    "source_text": "Hello, world!",
    "source_language": "en",
    "target_language": "es",
    "machine_translation": "Hola, mundo!",
    "suggested_translation": "¡Hola, mundo!"
}'

Mawallafi

{
    "id": 4213,
    "status": "pending",
    "created": true,
    "message": "Correction submitted for review."
}

Re-submitting the same source/language pair updates your existing suggestion instead of creating a duplicate (returns 200 with "created": false).

QFontDatabase

Mun yi amfani da tsarin fassara mai sauki mai sauki wanda ke aiki akan ginin GPU na kanmu. Dukkanin nau'ikan suna da lasisin kasuwanci (Apache 2.0).

@ action	@ action	QPrintPreviewDialog
Helsinki-NLP/opus-mt	KCharselect unicode block name	Harsuna masu yawa (EN, ES, FR, DE, IT, PT, RU, ZH, JA, da dai sauransu)
Google MADLAD-400	@ item Spelling dictionary	@ item Spelling dictionary

The API automatically chooses the best model for your language pair. You can optionally specify an engine Paramita:

Injin	Bayani
`"auto"`	Default. Trys HuggingFace first, falls back to MADLAD-400
`"huggingface"`	Ka tilasta HuggingFace/MarianMT (mafi sauri, harsuna 50+)
`"madlad"`	Force MADLAD-400 (400+ harsuna)

QSoftKeyManager

The API uses standard HTTP status codes to indicate success or failure.

KCharselect unicode block name	Bayani
200	QDialogButtonBox
202	Accepted — Batch job queued successfully
400	Bad Request — Invalid parameters (missing text, unsupported language, etc.)
401	Ba'a yarda ba - Maɓallin API da ba'a yarda da shi ko kuma da aka rasa
402	Payment Required — Character credits exhausted. Upgrade your plan or purchase a top-up.
403	Forbidden — API key lacks required scope or IP not in whitelist
503	QDialogButtonBox

QFileDialog

{
    "error": "insufficient_credits",
    "credits_remaining": 0
}

Usage Limits

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:

QPrintPreviewDialog	@ action	Batch API	Documents	QShortcut
QDialogButtonBox	250,000	—	—	$0	Yi rijista
@ action	2,500,000			$9/MB	@ action
QShortcut	10,000,000			$29/MB	@ action
QFontDatabase	40,000,000			$79/MB	@ action
@ action	125,000,000			$199/MB	@ action
Enterprise	Unlimited			$499/MB	Contact Sales

Kuma idan ka ƙẽtare iyãkanka, zã ka sãmi wata azãba mai raɗaɗi. 402 Payment Required mai amsa har zuwa wata mai zuwa ko ka canza.

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. All requests are queued and processed — send hundreds of concurrent requests and they'll all be handled. Real-time translations get priority, batch jobs process in the background.

Need More Credits?

Run out of characters mid-month? Purchase a one-time credit top-up without changing your plan. View top-up packs