For Agents
Translate text between 100+ languages, detect input language, transliterate scripts, and look up bilingual dictionary entries via Azure's machine translation service.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Azure Translator, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Azure Translator API.
Translate text between any of 100+ supported languages with optional profanity and HTML handling
Detect the language and script of an arbitrary input string before downstream processing
Transliterate text from one script to another (for example Cyrillic to Latin)
GET STARTED
Use for: Translate this English paragraph into Japanese, Detect the language of this customer message, Transliterate this Russian name into Latin script, List all languages supported by Azure Translator
Not supported: Does not handle speech translation, document translation jobs, or custom-trained model management — use for synchronous text translation, detection, transliteration, and dictionary lookup only.
Jentic publishes the only available OpenAPI specification for Azure Translator, keeping it validated and agent-ready. Azure Translator is Microsoft's cloud machine translation service exposing a JSON-based v3 Web API for text translation across 100+ languages, language detection, transliteration between scripts, sentence boundary detection, and bilingual dictionary lookup. It authenticates with an Azure subscription key passed in the Ocp-Apim-Subscription-Key header and is billed through the customer's Azure Cognitive Services Translator resource. The seven endpoints cover the full v3 surface used by translation, localisation, and content classification agents.
Break text into sentence-bounded segments for downstream NLP pipelines
Look up bilingual dictionary entries with back-translations for higher quality glossary work
Retrieve example sentences for a translated word pair to ground translation choices
List the languages supported by the translation, transliteration, and dictionary surfaces
Patterns agents use Azure Translator API for, with concrete tasks.
★ Multilingual Customer Support
An agent receives an inbound message in any language, calls /detect to identify the source, then calls /translate to produce English (or any agent-side language) so the support assistant can respond. The reply is translated back to the customer's language before sending.
Detect the language of an incoming support ticket and translate it to English using POST /translate with from inferred from /detect.
Content Localisation Pipeline
Marketing or documentation content is translated into multiple target languages in a single call by passing several to-language codes. The same workflow can transliterate brand names into target scripts and pull dictionary examples to vet ambiguous terms.
Translate a 500-word product description into Japanese, German, and Brazilian Portuguese in one POST /translate call with to=ja&to=de&to=pt-br.
Search and Indexing Across Languages
Before indexing user-generated content, an agent uses /detect to record the language and /breaksentence to chunk long documents into searchable units. This produces clean multilingual embeddings for downstream retrieval.
For a batch of 50 forum posts, call POST /detect to tag each with a language code, then POST /breaksentence on posts longer than 200 characters.
Agent Translation via Jentic
Through Jentic, an agent searches for translation operations by intent and receives the schema for /translate without parsing docs. The Azure subscription key is stored in the Jentic vault and injected at execution time so the agent never handles the secret.
Use Jentic search 'translate text from english to japanese', load schema for POST /translate, and execute with body=[{"Text":"Hello world"}] and to=ja.
7 endpoints — jentic publishes the only available openapi specification for azure translator, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/translate
Translate text into one or more target languages
/detect
Detect the language of input text
/languages
List supported languages
/transliterate
Transliterate text between scripts
/breaksentence
Break text into sentences
/dictionary/lookup
Look up bilingual dictionary entries
/dictionary/examples
Get example sentences for a dictionary entry
/translate
Translate text into one or more target languages
/detect
Detect the language of input text
/languages
List supported languages
/transliterate
Transliterate text between scripts
/breaksentence
Break text into sentences
Three things that make agents converge on Jentic-routed access.
Credential isolation
The Azure Translator subscription key is stored encrypted in the Jentic vault (MAXsystem) and injected into the Ocp-Apim-Subscription-Key header at execution time. The raw key never enters the agent's context.
Intent-based discovery
Agents search by intent (e.g., 'translate text from english to japanese') and Jentic returns the matching Translator operation with the input schema, so the agent can call POST /translate without parsing Azure docs.
Time to first call
Direct Azure Translator integration: half a day to provision the resource, manage the subscription key, and write retry logic for 429s. Through Jentic: under 30 minutes — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using Azure Translator API through Jentic.
Why is there no official OpenAPI spec for Azure Translator?
Microsoft does not publish a dedicated OpenAPI specification for the Translator v3 Text API. Jentic generates and maintains this spec so that AI agents and developers can call Azure Translator 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 Azure Translator API use?
The API uses an Azure subscription key passed in the Ocp-Apim-Subscription-Key header. The key is provisioned with the Translator resource in the Azure portal. Through Jentic, the subscription key sits in the encrypted vault and is injected on each call without entering the agent's context.
Can I translate to multiple target languages in one call?
Yes. POST /translate accepts the to query parameter multiple times (e.g. to=ja&to=de&to=fr) and returns translations for each in a single response, which keeps batch localisation work to one network round trip.
What are the rate limits for Azure Translator?
Azure Translator throttles by characters per hour and by request rate, with limits depending on the pricing tier (F0 free, S1+ standard) selected on the Translator resource. Limits are documented in the Azure Translator service documentation; expect a 429 with a Retry-After header when exceeded.
How do I translate text through Jentic?
Run pip install jentic, then search for 'translate text', load the schema for POST /translate, and execute with the body array of texts and the to language code. Jentic injects your stored Ocp-Apim-Subscription-Key at execution time.
Does Azure Translator support speech translation?
No. The endpoints in this spec cover the v3 Text Translation surface only. Speech-to-speech translation is provided by a separate Azure Speech service and is not part of this API.
/dictionary/lookup
Look up bilingual dictionary entries
/dictionary/examples
Get example sentences for a dictionary entry