← Knowledge base

Translation API

Last updated: 2026-09-06

The Pela Translation API is a single endpoint — POST /v2/translate — backed by the same engine as the Pela apps. Send text, a target language, and a Pela API key.

Base URL and authentication

https://app.pelapela.app

Send your key in the Authorization header:

Authorization: Bearer pela_xxxxxxxxxxxx

Create and revoke keys in Settings → API keys (app or web portal). A new key is shown only once — store it securely. Never put a key in a support message.

Translate text

POST /v2/translate

Field Type Description
text (required) string or string[] One or more strings. Max 50 per request.
target_lang (required) string EN, ES, JA, ZH, KO, PT, FR, IT, DE. Regional variants like EN-US accepted.
source_lang (optional) string Omit to auto-detect.

Example

curl -X POST https://app.pelapela.app/v2/translate \
  -H "Authorization: Bearer pela_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "text": ["Hello, how are you?"], "target_lang": "JA" }'
{
  "translations": [
    { "detected_source_language": "EN", "text": "こんにちは、お元気ですか?" }
  ]
}

Errors

Status Meaning
400 Invalid request or missing target_lang
401 Missing authorization header
403 Invalid or revoked API key
413 Text too long
429 Rate limited — retry with backoff
456 Quota exceeded
500 Internal error — retry, then contact support

Billing

API usage draws on your credit balance. See the plan and balance in Settings → billing. Pay-as-you-go top-ups are available for accounts without a subscription.

Not the same as the MCP server

The PelaPela MCP server tunes how a third-party LLM translates. This API performs the translation directly.