Translator API

The Translator API delivers scalable, high-performance machine translation for text across a broad range of languages and use cases.

It enables organizations to translate content inline for real-time interactions or process large collections of documents in bulk.

Key features

• Translates text to a single target language per request
• Supports bidirectional translation between English and eight supported languages
• Accepts plain text input for fast, inline translation of messages, UI strings, and short content
• Supports file-based batch translation for documents and large archives stored in cloud storage

Processing modes

Fast mode

Fast mode provides synchronous, low-latency translation for individual text inputs.

• Translates plain text in a single API call
• Returns a response immediately after translation completes
• Works best for short text like chat messages, UI strings, and workflow actions

For details, see Fast mode.

Batch mode

Batch mode provides asynchronous translation for large or complex jobs. Batch mode is best for long documents and large collections of text files.

• Processes one file, a manifest of files, or an entire storage prefix in a single request
• Runs in the background — submit jobs and retrieve results when processing is complete

Each input file generates its own translated output file in the corresponding output location.

For details, see Batch mode.

Supported languages

Translation is bidirectional with English: every job must have either source_language or target_languages set to en-US. Pairs between two non-English languages aren't supported yet.

Language codes are case-insensitive.