# 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 near 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.

It processes a single file, a manifest of files, or an entire storage prefix in one request. The job runs in the background and allows you to monitor progress and retrieve results later.

Batch mode is best for long documents and large collections of text files.

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               |