A Node.js/Express + React playground for the Zoom AI Services APIs. Test Scribe (speech-to-text), Translator, and Summarizer through a web UI backed by a tRPC server that handles JWT authentication and all API communication.
| Product | Modes | Description |
|---|---|---|
| Scribe | Fast (Sync) | Upload or record audio/video, get a transcript immediately |
| Scribe | Batch | Process thousands of S3 files; auto-splits jobs >1,000 files |
| Translator | Fast (Sync) | Translate up to 4,000 characters into one of 9 supported languages |
| Translator | Batch | Translate .txt files stored in S3 |
| Summarizer | Fast (Sync) | Summarize a transcript (up to 96 KB) — recap, action items, summary, or full summary |
| Summarizer | Batch | Summarize transcripts stored in S3 |
playground/ Vite + React + tRPC client (port 5173)
└── /trpc ──▶ Express + tRPC server (port 4000)
├── Zoom AI Services API
└── AWS S3 (for batch jobs)
The playground proxies /trpc to the Express server. All Zoom API calls happen server-side; the browser never touches Zoom credentials.
- Zoom Build Platform credentials
- Node.js 24+
- For batch jobs: an AWS account with an S3 bucket and IAM credentials
git clone https://github.com/zoom/scribe-quickstart.git
cd scribe-quickstart
npm install
cp .env.example .envEdit .env:
| Variable | Required | Description |
|---|---|---|
ZOOM_API_KEY |
Yes | Zoom Build Platform API key |
ZOOM_API_SECRET |
Yes | Zoom Build Platform API secret |
PORT |
No | Server port (default: 4000) |
For batch jobs also set:
| Variable | Description |
|---|---|
AWS_ACCESS_KEY_ID |
IAM access key — forwarded to Zoom to read/write your S3 bucket |
AWS_SECRET_ACCESS_KEY |
IAM secret key |
AWS_SESSION_TOKEN |
Session token (if using temporary credentials) |
WEBHOOK_SECRET |
HMAC secret to verify incoming webhook payloads |
Use scripts/generate-sts-creds.sh to generate temporary STS credentials:
./scripts/generate-sts-creds.sh <AWS_ACCESS_KEY_ID> <AWS_SECRET_ACCESS_KEY># Terminal 1 — API server
npm start
# Terminal 2 — Playground UI
cd playground && npm install && npm run devOpen http://localhost:5173.
The server exposes three webhook endpoints for Zoom batch job notifications: POST /webhooks/scribe, POST /webhooks/translator, and POST /webhooks/summarizer. All three require a publicly reachable HTTPS URL — use cloudflared for local development:
cloudflared tunnel --url http://localhost:4000Paste the printed URL into the Webhook URL field when submitting a batch job in the playground. Set WEBHOOK_SECRET in .env to the same value you submit alongside it — the server uses it to verify the x-zm-signature header on incoming callbacks.