Fast mode

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.

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:

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)

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