Skip to main content
GET
/
v3
/
history
curl -X GET "https://api.audixa.ai/v3/history?limit=10" \
  -H "x-api-key: YOUR_API_KEY"

import audixa

audixa.set_api_key("YOUR_API_KEY")

history = audixa.history(limit=10)
for item in history:
    print(f"{item['generation_id']}: {item['status']}")

import Audixa from 'audixa';

const audixa = new Audixa('YOUR_API_KEY');

const { history } = await audixa.getHistory({ limit: 10 });
for (const item of history) {
  console.log(`${item.generation_id}: ${item.status}`);
}

import Audixa from 'audixa';

const audixa = new Audixa('YOUR_API_KEY');

const { history } = await audixa.getHistory({ limit: 10 });
history.forEach(item => {
  console.log(`${item.generation_id}: ${item.status}`);
});

{
  "limit": 10,
  "offset": 0,
  "length": 1,
  "history": [
    {
      "generation_id": "gen_abc123",
      "status": "COMPLETED",
      "voice_id": "am_ethan",
      "voice_name": "Ethan",
      "model": "base",
      "tokens": 25,
      "dollar_cost": 0.000025,
      "audio_url": "https://cdn.audixa.ai/audio/gen_abc123.mp3",
      "created_at": "2025-02-05T12:00:00Z"
    }
  ]
}
Retrieve your TTS generation history in reverse chronological order (most recent first).
Endpoint
GET https://api.audixa.ai/v3/history

​
Request

​
limit
integer
default:"20"
Maximum results to return (1-100).
​
offset
integer
default:"0"
Number of results to skip.
​
status
string
Filter by status: IN_QUEUE, GENERATING, COMPLETED, FAILED, EXPIRED.

​
Response

​
limit
integer
Limit used for pagination.
​
offset
integer
Offset used for pagination.
​
length
integer
Number of results returned.
​
history
array
List of generation objects.
curl -X GET "https://api.audixa.ai/v3/history?limit=10" \
  -H "x-api-key: YOUR_API_KEY"

import audixa

audixa.set_api_key("YOUR_API_KEY")

history = audixa.history(limit=10)
for item in history:
    print(f"{item['generation_id']}: {item['status']}")

import Audixa from 'audixa';

const audixa = new Audixa('YOUR_API_KEY');

const { history } = await audixa.getHistory({ limit: 10 });
for (const item of history) {
  console.log(`${item.generation_id}: ${item.status}`);
}

import Audixa from 'audixa';

const audixa = new Audixa('YOUR_API_KEY');

const { history } = await audixa.getHistory({ limit: 10 });
history.forEach(item => {
  console.log(`${item.generation_id}: ${item.status}`);
});

{
  "limit": 10,
  "offset": 0,
  "length": 1,
  "history": [
    {
      "generation_id": "gen_abc123",
      "status": "COMPLETED",
      "voice_id": "am_ethan",
      "voice_name": "Ethan",
      "model": "base",
      "tokens": 25,
      "dollar_cost": 0.000025,
      "audio_url": "https://cdn.audixa.ai/audio/gen_abc123.mp3",
      "created_at": "2025-02-05T12:00:00Z"
    }
  ]
}

​
Error Responses

Missing or invalid API key.
{
  "detail": "Invalid or missing API key"
}
Rate limit exceeded.
{
  "detail": "Rate limit exceeded. Please retry after 30 seconds."
}