Quick Start - AudioPod AI

TL;DR: Register → Verify email → Create API key → Add funds → Make API calls.

Want to hear a result before creating an account? The sandbox issues a short-lived key (valid ~1 hour, small built-in credit balance) so you can make a real text-to-speech call in two requests.

cURL
Python

# 1. Mint a sandbox key (no auth required)
SANDBOX_KEY=$(curl -s -X POST "https://api.audiopod.ai/api/v1/sandbox/key" | jq -r '.key')

# 2. Synthesize a short snippet (max 200 characters) — returns audio bytes
curl -s -X POST "https://api.audiopod.ai/api/v1/sandbox/tts" \
  -H "Content-Type: application/json" \
  -d "{\"key\": \"$SANDBOX_KEY\", \"text\": \"Hello from the AudioPod sandbox!\"}" \
  --output sandbox.mp3

import requests

# 1. Mint a sandbox key (no auth required)
key = requests.post("https://api.audiopod.ai/api/v1/sandbox/key").json()["key"]

# 2. Synthesize a short snippet (max 200 characters)
audio = requests.post(
    "https://api.audiopod.ai/api/v1/sandbox/tts",
    json={"key": key, "text": "Hello from the AudioPod sandbox!"},
)
with open("sandbox.mp3", "wb") as f:
    f.write(audio.content)

Rather not copy-paste? The same two requests are the first folder of our Getting Started Postman collection. Fork it and run them — it stores the sandbox key for you between the two calls.

The sandbox is rate-limited and capped at 200 characters per call — it’s for a first taste, not production. Ready for the full API? Continue below.

Choose Your Path

🖥️ cURL
🌐 App

Complete setup directly with cURL commands.

Step 1: Create Your Account

CLI
Dashboard

curl -X POST "https://api.audiopod.ai/api/v1/auth/initiate-registration" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com",
    "password": "YourSecurePassword123",
    "full_name": "Your Name"
  }'

✅ Check your email for a 6-digit verification code.

Step 2: Verify Your Email

CLI
Dashboard

curl -X POST "https://api.audiopod.ai/api/v1/auth/verify-registration" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com",
    "verification_code": "123456"
  }'

Response includes your JWT token:

{
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "token_type": "bearer"
}

Save the access_token — you need it for Step 3!

Step 3: Create Your API Key

CLI
Dashboard

# Use the access_token from Step 2
curl -X POST "https://api.audiopod.ai/api/v1/auth/api-keys" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "my-first-key", "scopes": ["*"]}'

Response:

{
  "api_key": "ap_xxxxxxxxxxxxxxxxxxxxxxxx"
}

Save this key immediately! It’s only shown once.

Step 4: Set Up Your Environment

# Add to your shell profile (~/.bashrc, ~/.zshrc)
export AUDIOPOD_API_KEY="ap_your_api_key_here"

Or create a .env file:

AUDIOPOD_API_KEY=ap_your_api_key_here

Step 5: Add Funds to Your Wallet

CLI
Dashboard

# Get a Stripe payment link
curl -X POST "https://api.audiopod.ai/api/v1/api-wallet/topup/checkout" \
  -H "X-API-Key: $AUDIOPOD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount_cents": 500}'

Open the returned url in your browser to complete payment.

Step 6: Make Your First API Call! 🎉

Python
Node.js
cURL

pip install audiopod

from audiopod import AudioPod

client = AudioPod()  # Uses AUDIOPOD_API_KEY env var

# Separate a song into stems
result = client.stems.separate(
    url="https://youtube.com/watch?v=dQw4w9WgXcQ",
    mode="six"
)

print("🎵 Stems ready!")
for stem, url in result["download_urls"].items():
    print(f"  {stem}: {url[:50]}...")

npm install audiopod

import AudioPod from 'audiopod';

const client = new AudioPod();

const result = await client.stems.separate({
  url: 'https://youtube.com/watch?v=dQw4w9WgXcQ',
  mode: 'six'
});

console.log('🎵 Stems ready!');
Object.entries(result.download_urls).forEach(([stem, url]) => {
  console.log(`  ${stem}: ${url.substring(0, 50)}...`);
});

# Separate audio into 6 stems
curl -X POST "https://api.audiopod.ai/api/v1/stem-extraction/api/extract" \
  -H "X-API-Key: $AUDIOPOD_API_KEY" \
  -F "url=https://youtube.com/watch?v=dQw4w9WgXcQ" \
  -F "mode=six"

# Check job status (replace JOB_ID)
curl -X GET "https://api.audiopod.ai/api/v1/stem-extraction/status/JOB_ID" \
  -H "X-API-Key: $AUDIOPOD_API_KEY"

Pricing

Pay only for what you use. No subscriptions required for API access.

Service	Rate	$10 Gets You
Stem Separation	$0.10/min	100 min
Transcription	$0.01/min	1,000 min
Voice Cloning/TTS	$0.04/min	250 min
Voice Conversion	$0.13/min	77 min
Speech Translation	$0.40/min	25 min
Music Generation	$0.04/min	250 min
Speaker Separation	$0.20/min	50 min
Karaoke Generation	$0.25/min	40 min

Full Pricing

View complete pricing for all services

Try More Features

Transcription
Music Generation
Voice Cloning
Noise Reduction

# Convert speech to text
result = client.transcription.create(
    url="https://youtube.com/watch?v=VIDEO_ID"
)
print(result["transcript"])

# Generate music from text
song = client.music.generate(
    prompt="upbeat electronic dance music"
)
print(song["output_url"])

# Clone a voice from audio
voice = client.voice.clone(
    file="./sample.wav",
    name="My Voice"
)

# Generate speech with cloned voice
audio = client.tts.generate(
    text="Hello world!",
    voice_id=voice["id"]
)

# Remove background noise
clean = client.denoiser.denoise(
    file="./noisy_audio.wav"
)
print(clean["output_url"])

Manage Your Account (via CLI)

Once you have an API key, manage everything via cURL:

# Check wallet balance
curl -s "https://api.audiopod.ai/api/v1/api-wallet/balance" \
  -H "X-API-Key: $AUDIOPOD_API_KEY" | jq .

# List your API keys
curl -s "https://api.audiopod.ai/api/v1/auth/api-keys" \
  -H "X-API-Key: $AUDIOPOD_API_KEY" | jq .

# Create another API key
curl -X POST "https://api.audiopod.ai/api/v1/auth/api-keys" \
  -H "X-API-Key: $AUDIOPOD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "production-key", "scopes": ["*"]}'

# View usage history
curl -s "https://api.audiopod.ai/api/v1/api-wallet/usage" \
  -H "X-API-Key: $AUDIOPOD_API_KEY" | jq .

Common Issues

401 Unauthorized

Your API key is invalid or missing.Fix: Check the X-API-Key header is set correctly:

echo $AUDIOPOD_API_KEY  # Should print your key

402 Insufficient Balance

Your wallet is empty.Fix: Add funds via CLI or dashboard:

curl -X POST "https://api.audiopod.ai/api/v1/api-wallet/topup/checkout" \
  -H "X-API-Key: $AUDIOPOD_API_KEY" \
  -d '{"amount_cents": 500}'

Job Stuck in Processing

Audio processing jobs can take time depending on file length.Fix: Poll the status endpoint:

curl "https://api.audiopod.ai/api/v1/stem-extraction/status/JOB_ID" \
  -H "X-API-Key: $AUDIOPOD_API_KEY"

Building a startup?

AudioPod for Startups gives eligible early-stage teams free Pro access plus API credits to build on. Apply at audiopod.ai/startups.

Next Steps

SDK Docs

Full SDK reference for Python & Node.js

API Reference

Detailed endpoint documentation

Pricing

Complete pricing & wallet management

Postman

Fork the collections instead of copy-pasting

​Try it first — no signup

​Choose Your Path

​Step 1: Create Your Account

Sign Up

​Step 2: Verify Your Email

​Step 3: Create Your API Key

​Step 4: Set Up Your Environment

​Step 5: Add Funds to Your Wallet

​Step 6: Make Your First API Call! 🎉

​Pricing

Full Pricing

​Try More Features

​Manage Your Account (via CLI)

​Common Issues

​Building a startup?

​Next Steps

SDK Docs

API Reference

Pricing

Postman

Try it first — no signup

Choose Your Path

Step 1: Create Your Account

Step 2: Verify Your Email

Step 3: Create Your API Key

Step 4: Set Up Your Environment

Step 5: Add Funds to Your Wallet

Step 6: Make Your First API Call! 🎉

Pricing

Try More Features

Manage Your Account (via CLI)

Common Issues

Building a startup?

Next Steps