Direct retrieval
Orator API Endpoints
Retrieve Async Audio
Retrieve audio generated by async text-to-speech endpoints
This endpoint retrieves audio files generated by both async TTS endpoints. Requires the mediaId and JWT token returned from the async synthesis request.
Behavior depends on the originating endpoint:
From /text-to-speech-async:
- Returns complete audio file when ready
- Typically available within 1-2 seconds
- Best for bots and webhooks needing complete files
From /text-to-speech/stream-async:
- Supports chunked streaming with ~300ms first chunk latency
- Audio streams progressively as it’s generated
- Best for frontend apps and real-time playback
Key features:
- Direct access - Can be accessed directly by clients without your API key
- Secure - JWT token ensures only authorized access to the audio
- CDN-ready - Optimized for content delivery networks
GET
Direct retrieval
Path Parameters
The media ID returned from the async TTS request
Example:
"media_abc123xyz"
Query Parameters
JWT token for authentication
Example:
"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
Response
200
audio/*
Audio file retrieved successfully
The response is of type file.