Skip to main content
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

string
required
The generation ID returned from POST /tts.

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

Use a short delay with backoff, and honor 429 plus any Retry-After header.

Timeout

Set a maximum polling duration appropriate for your application.

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

Missing or invalid API key.
Unknown generation ID, or a generation owned by another account.
Rate limit exceeded.