Create Generation

curl -X POST "https://api.audixa.ai/v3/tts" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "text": "Hello world from Audixa!",
    "voice_id": "am_ethan",
    "model": "base",
    "speed": 1.0,
    "audio_format": "wav",
    "language_code": "a"
  }'

import audixa

audixa.set_api_key("YOUR_API_KEY")

# Asynchronous generation (returns immediately)
generation_id = audixa.tts(
    "Hello world from Audixa!",
    voice_id="am_ethan",
    model="base",
)
print(f"Generation ID: {generation_id}")

# Or generate and wait for completion
audio_url = audixa.tts_and_wait(
    "Hello world from Audixa!",
    voice_id="am_ethan",
)

# Advanced model in a non-English language
audio_url = audixa.tts_and_wait(
    "Hallo, willkommen bei Audixa!",
    voice_id="am_ethan",
    model="advanced",
    language_code="de",
)

import Audixa from 'audixa';

const audixa = new Audixa('YOUR_API_KEY');

// Asynchronous generation
const { generation_id } = await audixa.startTTS({
  text: 'Hello world from Audixa!',
  voice_id: 'am_ethan',
  model: 'base'
});
console.log('Generation ID:', generation_id);

// Or generate and wait (convenience method)
const audioUrl = await audixa.generateTTS({
  text: 'Hello world from Audixa!',
  voice_id: 'am_ethan',
  model: 'base'
});
console.log('Audio URL:', audioUrl);

import Audixa from 'audixa';

const audixa = new Audixa('YOUR_API_KEY');

// Asynchronous generation
const { generation_id } = await audixa.startTTS({
  text: 'Hello world from Audixa!',
  voice_id: 'am_ethan',
  model: 'base'
});
console.log('Generation ID:', generation_id);

// Or generate and wait (convenience method)
const audioUrl = await audixa.generateTTS({
  text: 'Hello world from Audixa!',
  voice_id: 'am_ethan',
  model: 'base'
});
console.log('Audio URL:', audioUrl);

{
  "generation_id": "gen_abc123xyz",
  "status": "IN_QUEUE",
  "input_text": "Hello world from Audixa!",
  "voice_id": "am_ethan",
  "voice_name": "Ethan",
  "model": "base",
  "tokens": 6,
  "dollar_cost": 0.000006,
  "method": null,
  "created_at": "2025-02-05T12:00:00Z",
  "started_at": null,
  "completed_at": null
}

POST

tts

curl -X POST "https://api.audixa.ai/v3/tts" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "text": "Hello world from Audixa!",
    "voice_id": "am_ethan",
    "model": "base",
    "speed": 1.0,
    "audio_format": "wav",
    "language_code": "a"
  }'

import audixa

audixa.set_api_key("YOUR_API_KEY")

# Asynchronous generation (returns immediately)
generation_id = audixa.tts(
    "Hello world from Audixa!",
    voice_id="am_ethan",
    model="base",
)
print(f"Generation ID: {generation_id}")

# Or generate and wait for completion
audio_url = audixa.tts_and_wait(
    "Hello world from Audixa!",
    voice_id="am_ethan",
)

# Advanced model in a non-English language
audio_url = audixa.tts_and_wait(
    "Hallo, willkommen bei Audixa!",
    voice_id="am_ethan",
    model="advanced",
    language_code="de",
)

import Audixa from 'audixa';

const audixa = new Audixa('YOUR_API_KEY');

// Asynchronous generation
const { generation_id } = await audixa.startTTS({
  text: 'Hello world from Audixa!',
  voice_id: 'am_ethan',
  model: 'base'
});
console.log('Generation ID:', generation_id);

// Or generate and wait (convenience method)
const audioUrl = await audixa.generateTTS({
  text: 'Hello world from Audixa!',
  voice_id: 'am_ethan',
  model: 'base'
});
console.log('Audio URL:', audioUrl);

import Audixa from 'audixa';

const audixa = new Audixa('YOUR_API_KEY');

// Asynchronous generation
const { generation_id } = await audixa.startTTS({
  text: 'Hello world from Audixa!',
  voice_id: 'am_ethan',
  model: 'base'
});
console.log('Generation ID:', generation_id);

// Or generate and wait (convenience method)
const audioUrl = await audixa.generateTTS({
  text: 'Hello world from Audixa!',
  voice_id: 'am_ethan',
  model: 'base'
});
console.log('Audio URL:', audioUrl);

{
  "generation_id": "gen_abc123xyz",
  "status": "IN_QUEUE",
  "input_text": "Hello world from Audixa!",
  "voice_id": "am_ethan",
  "voice_name": "Ethan",
  "model": "base",
  "tokens": 6,
  "dollar_cost": 0.000006,
  "method": null,
  "created_at": "2025-02-05T12:00:00Z",
  "started_at": null,
  "completed_at": null
}

Submits a text-to-speech task and returns a generation_id for tracking. The audio is generated asynchronously—use the Get Generation endpoint to check when it’s ready.

Endpoint

POST https://api.audixa.ai/v3/tts

Request

string

required

The text to convert to speech. Maximum 50,000 characters (varies by plan).

string

required

The voice ID to use. Get available voices from /voices.

string

default:"base"

The model tier to use.

base: Standard high-quality voices. Lowest cost/latency.
advanced: Premium voices. Supports cloning and higher expressiveness.

number

default:"1.0"

Playback speed multiplier. Range: 0.5 to 2.0.

Advanced Model Settings

number

default:"2.5"

Controls how strictly the model follows the text/style. Range: 1.0 - 5.0.

number

default:"0.5"

Controls emotional fluctuation/expressiveness. Range: 0.0 - 1.0.

string

default:"wav"

Output format: wav or mp3.

string

Optional language code for the input text. The accepted values depend on model:

Base model uses single-letter codes: a (American English), b (British English), j (Japanese), z (Mandarin Chinese), e (Spanish), f (French), h (Hindi), i (Italian), p (Brazilian Portuguese).
Advanced model uses ISO 639-1 codes: en, ar, da, de, el, es, fi, fr, he, hi, it, ja, ko, ms, nl, no, pl, pt, ru, sv, sw, tr, zh.

If omitted, the model falls back to its default language.

Response

string

Unique identifier for this generation job. Use this to poll /tts.

string

Initial status: IN_QUEUE.

string

The input text that was submitted.

string

Voice ID used for generation.

string

Human-readable voice name.

string

TTS model used (base or advanced).

integer

Number of tokens consumed.

number

Cost in USD (set when generation completes).

string

Payment method used: API_WALLET or CREDITS_BALANCE.

string

URL to download the generated audio (when status=COMPLETED).

string

Error details if status=FAILED.

string

ISO 8601 timestamp of creation.

string

ISO 8601 timestamp when processing started.

string

ISO 8601 timestamp when processing completed.

curl -X POST "https://api.audixa.ai/v3/tts" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "text": "Hello world from Audixa!",
    "voice_id": "am_ethan",
    "model": "base",
    "speed": 1.0,
    "audio_format": "wav",
    "language_code": "a"
  }'

import audixa

audixa.set_api_key("YOUR_API_KEY")

# Asynchronous generation (returns immediately)
generation_id = audixa.tts(
    "Hello world from Audixa!",
    voice_id="am_ethan",
    model="base",
)
print(f"Generation ID: {generation_id}")

# Or generate and wait for completion
audio_url = audixa.tts_and_wait(
    "Hello world from Audixa!",
    voice_id="am_ethan",
)

# Advanced model in a non-English language
audio_url = audixa.tts_and_wait(
    "Hallo, willkommen bei Audixa!",
    voice_id="am_ethan",
    model="advanced",
    language_code="de",
)

import Audixa from 'audixa';

const audixa = new Audixa('YOUR_API_KEY');

// Asynchronous generation
const { generation_id } = await audixa.startTTS({
  text: 'Hello world from Audixa!',
  voice_id: 'am_ethan',
  model: 'base'
});
console.log('Generation ID:', generation_id);

// Or generate and wait (convenience method)
const audioUrl = await audixa.generateTTS({
  text: 'Hello world from Audixa!',
  voice_id: 'am_ethan',
  model: 'base'
});
console.log('Audio URL:', audioUrl);

import Audixa from 'audixa';

const audixa = new Audixa('YOUR_API_KEY');

// Asynchronous generation
const { generation_id } = await audixa.startTTS({
  text: 'Hello world from Audixa!',
  voice_id: 'am_ethan',
  model: 'base'
});
console.log('Generation ID:', generation_id);

// Or generate and wait (convenience method)
const audioUrl = await audixa.generateTTS({
  text: 'Hello world from Audixa!',
  voice_id: 'am_ethan',
  model: 'base'
});
console.log('Audio URL:', audioUrl);

{
  "generation_id": "gen_abc123xyz",
  "status": "IN_QUEUE",
  "input_text": "Hello world from Audixa!",
  "voice_id": "am_ethan",
  "voice_name": "Ethan",
  "model": "base",
  "tokens": 6,
  "dollar_cost": 0.000006,
  "method": null,
  "created_at": "2025-02-05T12:00:00Z",
  "started_at": null,
  "completed_at": null
}

Error Responses

400 Bad Request

Invalid parameters (e.g. invalid model, voice not found).

402 Payment Required

Insufficient balance.

429 Too Many Requests

Rate limit exceeded.

API Reference Get Generation

Overview

Endpoints

Streaming

Request

Advanced Model Settings

Response

Error Responses

​Request

​Advanced Model Settings

​Response

​Error Responses

Request

Advanced Model Settings

Response

Error Responses