# Fast mode

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

Fast mode provides synchronous translation for individual text inputs. The response returns immediately after translation completes.

## Capabilities

-   Single-call plain text translation
-   Immediate translation results
-   Optimized for short text, chat messages, UI strings, and notes

Fast mode supports one target language per request. The API returns a map of translated text keyed by target language code.

## Input

-   Supports plain text with a maximum input length of 4,000 characters
-   Covers chat messages, UI strings, short notes, and workflow actions

## Output

-   Returns a translations map as a JSON object with a translations key
-   Maps each target locale code (for example, "es-ES") to its corresponding translated text

## Translation options

These options control the source language and target languages. Both `source_language` and `target_languages` require BCP-47 locale codes (for example, `"en-US"`, `"es-ES"`). We do not accept short codes such as `"en"` and `"es"`.

| Parameter          | Type     | Default | Description                                                |
| ------------------ | -------- | ------- | ---------------------------------------------------------- |
| `source_language`  | string   | —       | Locale code of the input text (e.g., `"en-US"`).           |
| `target_languages` | string[] | —       | A single target language locale code (e.g., `["es-ES"]`).  |
| `reference_id`     | string   | —       | Optional client-supplied identifier for tracking requests. |

For the full list, see [Supported languages](/docs/ai-services/translator/#supported-languages).

## Text translation

Use this endpoint to send text for synchronous translation:

**`POST /aiservices/translator/translate`**

### Example request (cURL)

This cURL example sends a text string to the Translator API and returns the Spanish translation:

```shell
curl -X POST https://api.zoom.us/v2/aiservices/translator/translate \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello everyone, welcome to Zoom AI Services.",
    "config": {
      "source_language": "en-US",
      "target_languages": ["es-ES"]
    },
    "reference_id": "msg_456"
  }'
```

#### Response (200)

```json
{
    "request_id": "req_123",
    "result": {
        "translations": {
            "es-ES": "Translated text here."
        }
    }
}
```