Back
API documentation
Translate programmatically via a simple REST API.
1. Get your API key
Sign in and create a key in your profile (top-right avatar → API access). The key is shown only once, so save it right away.
2. Authentication
Send your key in the X-API-Key header on every request.
X-API-Key: ait_your_key_here3. Translate text
POST/api/v1/translate
Parameters
qrequiredText to translate (alias: text).targetrequiredTarget language, e.g. sk, en, de.sourceoptionalSource language, or auto to auto-detect (default).formatoptionaltext (default) or html — html keeps tags and also translates attributes.cURL
curl -X POST https://www.ai-translators.com/api/v1/translate \
-H "Content-Type: application/json" \
-H "X-API-Key: ait_your_key_here" \
-d '{"q":"Hello world","source":"en","target":"sk"}'JavaScript
const res = await fetch("https://www.ai-translators.com/api/v1/translate", {
method: "POST",
headers: {
"Content-Type": "application/json",
"X-API-Key": "ait_your_key_here",
},
body: JSON.stringify({ q: "Hello world", source: "en", target: "sk" }),
});
const data = await res.json();
console.log(data.translatedText); // "Ahoj svet"Python
import requests
r = requests.post(
"https://www.ai-translators.com/api/v1/translate",
headers={"X-API-Key": "ait_your_key_here"},
json={"q": "Hello world", "source": "en", "target": "sk"},
)
print(r.json()["translatedText"]) # "Ahoj svet"Response
200 OK
{
"translatedText": "Ahoj svet",
"detectedLanguage": null,
"engine": "standard"
}List languages
GET/api/v1/languages
cURL
curl https://www.ai-translators.com/api/v1/languages \
-H "X-API-Key: ait_your_key_here"Limits & plans
Free
50 000
characters / month · standard engine
Pro
2 000 000
characters / month · premium engine (Gemini)
Rate limit: 120 requests / minute. See pricing
Error codes
400Bad request — missing text or unsupported target language.401Missing or invalid API key (X-API-Key header).402Monthly character limit reached — upgrade to Pro for more.429Too many requests — slow down.502Translation temporarily failed — try again.