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"
}
]
}
Endpoints
History
List generation history
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
integer
default:"20"
Maximum results to return (1-100).
integer
default:"0"
Number of results to skip.
string
Filter by status:
IN_QUEUE, GENERATING, COMPLETED, FAILED, EXPIRED.Response
integer
Limit used for pagination.
integer
Offset used for pagination.
integer
Number of results returned.
array
List of generation objects.
Show History Item
Show History Item
string
Unique generation ID.
string
Generation status:
IN_QUEUE, GENERATING, COMPLETED, FAILED, EXPIRED.string
Voice ID used.
string
Human-readable voice name.
string
TTS model used.
integer
Number of tokens consumed.
number
Cost in USD.
string
Payment method used:
API_WALLET or CREDITS_BALANCE.string
Download URL (if status is COMPLETED).
string
ISO 8601 creation timestamp.
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
401 Unauthorized
401 Unauthorized
Missing or invalid API key.
{
"detail": "Invalid or missing API key"
}
429 Too Many Requests
429 Too Many Requests
Rate limit exceeded.
{
"detail": "Rate limit exceeded. Please retry after 30 seconds."
}
⌘I