Endpoints
Get Generation
Retrieve the status and details of a TTS generation
GET
Poll this endpoint to check if your generation is complete. When
status is COMPLETED, the audio_url field will contain the download link.
Endpoint
Request
Response
string
Unique identifier for the generation.
string
Current status:
IN_QUEUE, GENERATING, COMPLETED, FAILED.string
The input text that was submitted.
string
Voice ID used.
string
Human-readable voice name.
string
Model used:
base or advanced.integer
Number of tokens consumed.
number
Final cost in USD.
string
Payment source:
CREDITS_BALANCE (Monthly) or API_WALLET (Topup).string
Download URL for the audio file (only when status is
COMPLETED).string
Error details if status is
FAILED.string
ISO 8601 creation timestamp.
string
ISO 8601 timestamp when processing started.
string
ISO 8601 timestamp when processing completed.
Polling Best Practices
Poll Interval
Poll every 1-2 seconds. Don’t poll faster than once per second.
Timeout
Set a maximum timeout (e.g., 60 seconds) to avoid infinite loops.
Error Handling
Always handle the
FAILED status gracefully with retry logic.Cache Results
Once completed, cache the
audio_url to avoid re-polling.Error Responses
404 Not Found
404 Not Found
Invalid or expired generation ID.
Generation IDs expire 24 hours after creation.
429 Too Many Requests
429 Too Many Requests
Rate limit exceeded.