Translate content in a single request. POST key-value data, get translations back — your localization engine applies glossary, brand voice, instructions, and per-locale model selection on every call.
Use localize to translate. Use recognize to detect a language.
Base URL#
text
https://api.lingo.devAuthentication#
All API requests require an API key passed in the X-API-Key header.
bash
X-API-Key: your_api_keyAPI keys are scoped to an organization. Each key has access to all localization engines within that organization. Generate keys in the API Keys section of the dashboard.
Key visibility
API keys are shown only once at creation. Store them securely - they cannot be retrieved after the initial display.
Error codes#
Errors are returned as JSON with a message field describing what went wrong.
json
{
"message": "Invalid API key"
}| Status | Meaning |
|---|---|
400 Bad Request | Request validation failed (missing fields, invalid locale, etc.) |
401 Unauthorized | Missing or invalid X-API-Key header |
402 Payment Required | Organization has hit its credit limit |
403 Forbidden | API key does not have access to the requested resource |
404 Not Found | Resource (engine, job, etc.) does not exist |
429 Too Many Requests | Organization has hit its daily token quota — upgrade the plan to raise the limit |
500 Internal Server Error | Unexpected failure — database error, or the translation call failed across all configured models |
Endpoints#
Localize
Translate key-value pairs from one locale to another
Recognize
Detect the language of arbitrary text