# Translator API

<!-- WARNING: THIS FILE WAS AUTOGENERATED! DO NOT EDIT! -->

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](/docs/ai-services/translator/#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](/docs/ai-services/translator/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](/docs/ai-services/translator/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.

| Locale code | Language              |
| ----------- | --------------------- |
| `en-US`     | English               |
| `zh-CN`     | Chinese (Simplified)  |
| `zh-TW`     | Chinese (Traditional) |
| `ja-JP`     | Japanese              |
| `ko-KR`     | Korean                |
| `es-ES`     | Spanish               |
| `fr-FR`     | French                |
| `de-DE`     | German                |
| `pt-BR`     | Portuguese            |
| `it-IT`     | Italian               |