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

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

Missing or invalid API key.
Invalid or expired generation ID.
Generation IDs expire 24 hours after creation.
Rate limit exceeded.