Quickstart

pip install audixa

npm install audixa

import audixa

# Set your API key (or use AUDIXA_API_KEY env variable)
audixa.set_api_key("YOUR_API_KEY")

# Generate TTS and get audio URL
audio_url = audixa.tts_and_wait(
    "Hello! Welcome to Audixa, the best text-to-speech API.",
    voice_id="am_ethan",
)
print(f"Audio URL: {audio_url}")

# Or save directly to file
audixa.tts_to_file(
    "Hello! Welcome to Audixa.",
    "output.wav",
    voice_id="am_ethan",
)

import Audixa from 'audixa';

const audixa = new Audixa('YOUR_API_KEY');

// Generate TTS and wait for completion
const audioUrl = await audixa.generateTTS({
  text: 'Hello! Welcome to Audixa, the best text-to-speech API.',
  voice_id: 'am_ethan',
  model: 'base'
});

console.log('Audio URL:', audioUrl);

import Audixa from 'audixa';

const audixa = new Audixa('YOUR_API_KEY');

const audioUrl = await audixa.generateTTS({
  text: 'Hello! Welcome to Audixa, the best text-to-speech API.',
  voice_id: 'am_ethan',
  model: 'base'
});

console.log('Audio URL:', audioUrl);

# Step 1: Start TTS job
curl -X POST "https://api.audixa.ai/v3/tts" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "text": "Hello! Welcome to Audixa, the best text-to-speech API.",
    "voice_id": "am_ethan",
    "model": "base"
  }'

# Response: {"generation_id": "gen_abc123xyz789"}

# Step 2: Poll for status
curl -X GET "https://api.audixa.ai/v3/tts?generation_id=gen_abc123xyz789" \
  -H "x-api-key: YOUR_API_KEY"

# Response when complete: {"status": "Completed", "audio_url": "https://..."}

import audixa

audixa.set_api_key("YOUR_API_KEY")

# Base model with speed adjustment
audio_url = audixa.tts_and_wait(
    "Welcome to Audixa AI, your text-to-speech solution.",
    voice_id="am_ethan",
    model="base",
    speed=1.1,  # Slightly faster (0.5 to 2.0)
)

# Advanced model with expressiveness controls
audio_url = audixa.tts_and_wait(
    "This is exciting news! We have launched.",
    voice_id="am_ethan",
    model="advanced",
    cfg_weight=3.5,       # Controls how strictly the model follows the style (1.0-5.0)
    exaggeration=0.7,     # Controls emotional expressiveness (0.0-1.0)
    audio_format="mp3",   # Output format: "wav" or "mp3"
)

import Audixa from 'audixa';

const audixa = new Audixa('YOUR_API_KEY');

// Base model with speed adjustment
const audioUrl = await audixa.generateTTS({
  text: 'Welcome to Audixa AI, your text-to-speech solution.',
  voice_id: 'am_ethan',
  model: 'base',
  speed: 1.1  // Slightly faster (0.5 to 2.0)
});

// Advanced model with expressiveness controls
const expressiveUrl = await audixa.generateTTS({
  text: 'This is exciting news! We have launched.',
  voice_id: 'am_ethan',
  model: 'advanced',
  cfg_weight: 3.5,       // Controls how strictly the model follows the style (1.0-5.0)
  exaggeration: 0.7,     // Controls emotional expressiveness (0.0-1.0)
  audio_format: 'mp3'    // Output format: "wav" or "mp3"
});

import Audixa from 'audixa';

const audixa = new Audixa('YOUR_API_KEY');

// Base model with speed adjustment
const audioUrl = await audixa.generateTTS({
  text: 'Welcome to Audixa AI, your text-to-speech solution.',
  voice_id: 'am_ethan',
  model: 'base',
  speed: 1.1
});

// Advanced model with expressiveness controls
const expressiveUrl = await audixa.generateTTS({
  text: 'This is exciting news! We have launched.',
  voice_id: 'am_ethan',
  model: 'advanced',
  cfg_weight: 3.5,
  exaggeration: 0.7,
  audio_format: 'mp3'
});