Translate API
Get an API key from the dashboard (Discord login, invite only).
Authentication
Send your key in one of these ways:
X-API-Key: tk_...header (recommended)Authorization: Bearer tk_...header
POST /v1/translate
curl -X POST /v1/translate \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"text": "Hello world", "target": "es"}'
| Field | Type | Description |
|---|---|---|
text | string | string[] | Text to translate. An array translates several strings in one request. |
target | string | Target language code (required). |
source | string | Source language code, default auto (auto-detect). |
format | string | text (default) or html. |
Response
{
"translatedText": "Hola mundo",
"source": "auto",
"target": "es",
"characters": 11,
"detectedLanguage": { "language": "en", "confidence": 90 }
}
Errors
400 | Bad request (missing text, unsupported language) |
401 | Missing / invalid / revoked API key |
413 | Text too long for one request |
429 | Rate limit or daily character limit reached |
502 / 503 | Translation backend error / unavailable |
GET /v1/languages
Lists supported language codes (no key required).
| Code | Language |
|---|
Examples
JavaScript
const res = await fetch("/v1/translate", {
method: "POST",
headers: { "Content-Type": "application/json", "X-API-Key": process.env.TRANSLATE_KEY },
body: JSON.stringify({ text: "Good morning", target: "ja" }),
});
const { translatedText } = await res.json();
Python
import requests
r = requests.post("/v1/translate",
headers={"X-API-Key": "YOUR_API_KEY"},
json={"text": "Good morning", "target": "de"})
print(r.json()["translatedText"])