Translate API

Get an API key from the dashboard (Discord login, invite only).

Authentication

Send your key in one of these ways:

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"}'
FieldTypeDescription
textstring | string[]Text to translate. An array translates several strings in one request.
targetstringTarget language code (required).
sourcestringSource language code, default auto (auto-detect).
formatstringtext (default) or html.

Response

{
  "translatedText": "Hola mundo",
  "source": "auto",
  "target": "es",
  "characters": 11,
  "detectedLanguage": { "language": "en", "confidence": 90 }
}

Errors

400Bad request (missing text, unsupported language)
401Missing / invalid / revoked API key
413Text too long for one request
429Rate limit or daily character limit reached
502 / 503Translation backend error / unavailable

GET /v1/languages

Lists supported language codes (no key required).

CodeLanguage

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"])