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.
The source and target can be any two supported languages. English doesn't have to be the source or target language.
Input
The API accepts the following input:
- Plain text with a maximum input length of 4,000 characters
- Chat messages, UI strings, and short notes
Output
- Returns
result.translations, an object keyed by target locale code - 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.
Use BCP-47 locale codes for source_language and target_languages (for example, "en-US", "es-ES"). Omit source_language to detect the input language automatically.
The API doesn't accept short codes such as "en" and "es".
| Parameter | Type | Default | Description |
|---|---|---|---|
source_language | string | Automatic detection | Optional locale code of the input text (e.g., "en-US"). Omit to detect the source language automatically. |
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 translates Spanish directly into German.
curl -X POST https://api.zoom.us/v2/aiservices/translator/translate \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"text": "Hola a todos. Bienvenidos a Zoom AI Services.",
"config": {
"source_language": "es-ES",
"target_languages": ["de-DE"]
},
"reference_id": "msg_456"
}'
Response (200)
{
"request_id": "3f2b8c1e-7a4d-4e9b-b6f0-1c5d8a2e9b47",
"result": {
"translations": {
"de-DE": "Hallo zusammen. Willkommen bei Zoom AI Services."
}
}
}