zoom Zoom AI Services Translator
Background reference for Zoom AI Services Translator across:
- synchronous plain-text translation (
POST /aiservices/translator/translate) - asynchronous batch text-file jobs (
/aiservices/translator/jobs*) - one-target-language translation workflows
- Build-platform JWT generation and server-side credential handling
- webhook-driven batch status updates
Official docs:
- https://developers.zoom.us/docs/ai-services/
- https://developers.zoom.us/docs/ai-services/translator/
- https://developers.zoom.us/docs/ai-services/translator/fast-mode/
- https://developers.zoom.us/docs/ai-services/translator/batch-mode/
- https://developers.zoom.us/api-hub/ai-services/methods/endpoints.json
- Quickstart sample: https://github.com/zoom/ai-services-quickstart/
Routing Guardrail
- If the user needs plain text translated, route here first.
- If the user needs audio/video transcribed before translation, route to ../scribe/SKILL.md, then chain here.
- If the user needs summaries or action items, route to ../summarizer/SKILL.md.
- If the user needs live meeting media before translation, route to ../rtms/SKILL.md.
- If the user needs the raw AI Services endpoint inventory, chain ../rest-api/SKILL.md.
- If the user needs webhook signature patterns, optionally chain ../webhooks/SKILL.md.
Quick Links
- scenarios/high-level-scenarios.md
- examples/fast-mode-node.md
- examples/batch-webhook-pipeline.md
- references/api-reference.md
- references/environment-variables.md
- references/samples-validation.md
- troubleshooting/common-drift-and-breaks.md
- RUNBOOK.md
Core Workflow
- Get Build-platform API key and API secret.
- Generate an HS256 JWT server-side.
- Choose fast mode for one text string or batch mode for stored text files.
- Set
source_languageand a singletarget_languagesentry. - Submit the request and persist
result.translations. - For batch jobs, poll job/file status or receive webhook notifications.
Endpoint Surface
| Mode | Method | Path | Use |
|---|---|---|---|
| Fast | POST |
/aiservices/translator/translate |
Synchronous translation for one text input |
| Batch | POST |
/aiservices/translator/jobs |
Submit asynchronous batch translation job |
| Batch | GET |
/aiservices/translator/jobs |
List batch translation jobs |
| Batch | GET |
/aiservices/translator/jobs/{jobId} |
Inspect job summary/state |
| Batch | DELETE |
/aiservices/translator/jobs/{jobId} |
Cancel queued/processing job |
| Batch | GET |
/aiservices/translator/jobs/{jobId}/files |
Inspect per-file results |
| Batch | GET |
/aiservices/translator/jobs/{jobId}/files/{fileId} |
Inspect one per-file result |
Mode Selection
| Need | Use |
|---|---|
One text value under 4,000 characters |
Fast mode |
.txt files in S3 |
Batch mode |
| Chat messages, UI strings, workflow actions | Fast mode |
| Large offline document archive | Batch mode |
Translation Guardrails
- Fast mode supports one target language per request.
- Batch mode supports one target language per job.
- Translation is bidirectional with English: every job must have either
source_languageortarget_languagesset toen-US. - Non-English to non-English pairs are not supported yet.
- Use BCP-47 locale codes such as
en-USandes-ES, not short codes such asen.
Chaining
- Media to transcript to translation -> ../scribe/SKILL.md +
translator - Summary to localized output -> ../summarizer/SKILL.md +
translator - Batch webhook receiver ->
translator+ ../webhooks/SKILL.md - Raw endpoint discovery -> ../rest-api/SKILL.md
- Cross-product routing -> ../general/SKILL.md
Operations
- RUNBOOK.md - 5-minute preflight and debugging checklist.