For Agents
Translate text between 21 languages, detect the language of a string, and list supported languages. Authenticated with an X-API-Key header.
Get started with Hirak Translation API in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"translate text between languages"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Hirak Translation API API.
Translate a string between any two supported languages with POST /translate
Detect the source language of an unlabelled string with POST /detect
Enumerate the 21 supported languages via GET /languages before submitting
Localise short user-generated content such as chat or comments
GET STARTED
Use for: I need to translate this text from English to French, I want to detect what language a comment is in, List all languages supported for translation, Translate user feedback into the support team's language
Not supported: Does not handle speech translation, document translation with formatting, or transliteration — use for plain-text translation and language detection across 21 languages only.
Jentic publishes the only available OpenAPI document for Hirak Translation API, keeping it validated and agent-ready.
Jentic publishes the only available OpenAPI specification for Hirak Translation API, keeping it validated and agent-ready. Hirak Translation translates text between 21 widely used languages and can detect the source language for an unlabelled string. The three-endpoint surface — POST /translate, GET /languages, and POST /detect — is authenticated with an X-API-Key header and is intended for chat translation, simple localisation tasks, and language-detection pre-processing in agent pipelines. Because the surface is small, integration is fast and the API behaves predictably under load.
Pre-process inbound text by detecting language before routing to a localised handler
Run cheap on-demand translation in agent workflows that don't need a heavyweight MT engine
Patterns agents use Hirak Translation API API for, with concrete tasks.
★ Chat Translation in Customer Support
Support tools translate inbound messages so agents can read them in their own language and reply in the customer's. POST /translate handles the round trip and POST /detect identifies the source language up front, so an agent can build a working chat translator without integrating a major MT vendor.
On every inbound chat message, call POST /detect to find the source language, then POST /translate to convert the body into en for the support agent.
User Generated Content Localisation
Forums and review sites localise short user-generated content for visitors. With a 21-language coverage list and a per-call /translate endpoint, an agent can translate comments lazily on render and cache the results without provisioning a translation pipeline.
When a visitor with locale fr-FR loads a review written in en, call POST /translate with from=en, to=fr and cache the result keyed on the review ID.
Language-Aware Routing
Multi-region products route inbound emails or tickets to the team that speaks the message's language. POST /detect returns the language code, which the agent uses to pick the right queue. Combined with /languages this also catches messages in unsupported scripts before they hit human agents.
For each inbound ticket body, call POST /detect and route the ticket to the matching language queue, falling back to en if the language code is not in the supported list.
AI Agent Multilingual Helper
An AI assistant works across languages by translating user input into English before reasoning and translating the answer back. Through Jentic, the agent searches for the translate operation, loads the schema, and executes POST /translate with the user's vault-stored X-API-Key.
When the user types in es, search Jentic for 'translate text', execute POST /translate to convert to en, run the agent's reasoning, then translate the response back to es with another /translate call.
3 endpoints — jentic publishes the only available openapi specification for hirak translation api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/translate
Translate text between two languages
/detect
Detect the language of a string
/languages
List supported languages
/translate
Translate text between two languages
/detect
Detect the language of a string
/languages
List supported languages
Three things that make agents converge on Jentic-routed access.
Credential isolation
Your Hirak Translation X-API-Key is stored encrypted in the Jentic vault (MAXsystem). The agent receives a scoped execution token, and Jentic injects the X-API-Key header at call time so the raw key never enters the model context.
Intent-based discovery
Agents search by intent (e.g., 'translate text' or 'detect language of text') and Jentic returns POST /translate or POST /detect with their body schemas, so the agent picks the right one without reading docs.
Time to first call
Direct Hirak Translation integration: a few hours for auth, language listing, and error handling. Through Jentic: under 15 minutes — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
OpenAI API
GPT-4 can translate and reason about text in one call across far more languages.
Choose OpenAI when broader language coverage or context-sensitive translation is needed; use Hirak for cheap fixed-language pairs.
MessageBird Language Detection API
Dedicated language detection API from MessageBird's NLP suite.
Choose MessageBird Language Detection when only detection is needed and you already use MessageBird; choose Hirak when you want translate and detect from one provider.
Abstract API
Bundle of utility APIs that pair with Hirak Translation for validation of post-translation text.
Use Abstract alongside Hirak when the agent needs to validate emails, phone numbers, or other fields after translation.
Specific to using Hirak Translation API API through Jentic.
Why is there no official OpenAPI spec for Hirak Translation API?
Hirak does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Hirak Translation API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Hirak Translation API use?
The Hirak Translation API uses an X-API-Key header on every call to /translate, /detect, and /languages. Through Jentic, the X-API-Key value is held in the MAXsystem vault and injected at execution time so the raw key never enters the agent context.
How many languages does the API support?
The engine supports 21 widely used languages. Call GET /languages to receive the full list, and pass the matching language codes to POST /translate's from and to parameters.
What are the rate limits for the Hirak Translation API?
The OpenAPI specification does not declare specific rate limits. Hirak enforces per-key quotas, so check your plan dashboard and batch translate calls when localising large documents to avoid hitting daily caps.
How do I detect a language and translate it through Jentic?
Run pip install jentic, then await client.search('detect language of text') followed by client.search('translate text'). Execute POST /detect first, then POST /translate with the detected source code as the from parameter.
Does the API translate documents or only short strings?
POST /translate accepts text in the request body. For documents, split content into paragraph-sized strings and call /translate per chunk, then re-assemble in order to preserve formatting.