curl -X GET "https://api.audixa.ai/v3/history?limit=10" \
-H "x-api-key: YOUR_API_KEY"
import requests
response = requests.get(
"https://api.audixa.ai/v3/history",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"limit": 10},
timeout=30,
)
response.raise_for_status()
for item in response.json()["history"]:
print(f"{item['generation_id']}: {item['status']}")
const query = new URLSearchParams({ limit: '10' });
const response = await fetch(`https://api.audixa.ai/v3/history?${query}`, {
headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
if (!response.ok) throw new Error(await response.text());
const { history } = await response.json();
for (const item of history) {
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 requests
response = requests.get(
"https://api.audixa.ai/v3/history",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"limit": 10},
timeout=30,
)
response.raise_for_status()
for item in response.json()["history"]:
print(f"{item['generation_id']}: {item['status']}")
const query = new URLSearchParams({ limit: '10' });
const response = await fetch(`https://api.audixa.ai/v3/history?${query}`, {
headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
if (!response.ok) throw new Error(await response.text());
const { history } = await response.json();
for (const item of history) {
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 requests
response = requests.get(
"https://api.audixa.ai/v3/history",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"limit": 10},
timeout=30,
)
response.raise_for_status()
for item in response.json()["history"]:
print(f"{item['generation_id']}: {item['status']}")
const query = new URLSearchParams({ limit: '10' });
const response = await fetch(`https://api.audixa.ai/v3/history?${query}`, {
headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
if (!response.ok) throw new Error(await response.text());
const { history } = await response.json();
for (const item of history) {
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."
}