Skip to main content
GET
https://api.audixa.ai
/
v2
/
status
curl -X GET "https://api.audixa.ai/v2/status?generation_id=gen_abc123xyz789" \
  -H "x-api-key: YOUR_API_KEY"

{
  "status": "Generating"
}
Retrieves the current status of a previously submitted TTS job. Once the status is Completed, the response includes an url to download the generated audio.

​
Request

​
generation_id
string
required
The generation ID returned from POST /tts.

​
Response

​
status
string
Current status of the generation job:
  • Generating - Audio is still being processed
  • Completed - Audio is ready for download
  • Failed - Generation failed (see detail for reason)
​
url
string
URL to download the generated MP3 file. Only present when status is Completed.
​
detail
string
Error message. Only present when status is Failed.

​
Examples

curl -X GET "https://api.audixa.ai/v2/status?generation_id=gen_abc123xyz789" \
  -H "x-api-key: YOUR_API_KEY"

{
  "status": "Generating"
}

​
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 url to avoid re-polling.

​
Error Responses

Missing or invalid API key.
{
  "detail": "Invalid or missing API key"
}
Invalid or expired generation ID.
{
  "detail": "Generation not found"
}
Generation IDs expire 24 hours after creation.
Rate limit exceeded.
{
  "detail": "Rate limit exceeded. Please retry after 30 seconds."
}