Official SDKs - AudioPod AI

Ready-to-Use SDKs

AudioPod AI provides official SDKs that make it easy to integrate audio processing into your applications. Our SDKs handle authentication, request formatting, polling for job completion, and error handling automatically.

Python SDK

pip install audiopodFull-featured Python SDK with type hints and async support.

Node.js SDK

npm install audiopodTypeScript-ready SDK with promise-based API.

Quick Comparison

Feature	Python	Node.js
Package	`audiopod`	`audiopod`
Min Version	Python 3.8+	Node 16+
Type Support	Type hints	Full TypeScript
Async Support	Yes	Yes
File Upload	Yes	Yes
URL Processing	Yes	Yes
Auto-polling	Yes	Yes

Installation

Python
Node.js

pip install audiopod

npm install audiopod
# or
yarn add audiopod

Quick Start

Python
Node.js

from audiopod import AudioPod

# Initialize client (uses AUDIOPOD_API_KEY env var)
client = AudioPod()
# Or pass API key directly
client = AudioPod(api_key="ap_your_api_key")

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

# Download stems
for stem, url in result["download_urls"].items():
    print(f"{stem}: {url}")

import AudioPod from 'audiopod';

// Initialize client (uses AUDIOPOD_API_KEY env var)
const client = new AudioPod();
// Or pass API key directly
const client = new AudioPod({ apiKey: 'ap_your_api_key' });

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

// Download stems
for (const [stem, url] of Object.entries(result.download_urls)) {
  console.log(`${stem}: ${url}`);
}

Available Services

Both SDKs provide access to the same set of services:

Service	Python	Node.js	Description
Audiobook	`client.audiobook`	`client.audiobook`	Manuscript → ACX-ready audiobook
Stems	`client.stems`	`client.stems`	Audio stem separation
Transcription	`client.transcription`	`client.transcription`	Speech-to-text
Voice	`client.voice`	`client.voice`	Voice cloning and TTS
Music	`client.music`	`client.music`	AI music generation
Denoiser	`client.denoiser`	`client.denoiser`	Noise reduction
Speaker	`client.speaker`	`client.speaker`	Speaker diarization
Wallet	`client.wallet`	`client.wallet`	Balance and billing

Error Handling

Both SDKs provide typed exceptions for common error scenarios:

Python
Node.js

from audiopod import AudioPod, AuthenticationError, InsufficientBalanceError

try:
    client = AudioPod(api_key="ap_...")
    result = client.stems.separate(url="...", mode="six")
except AuthenticationError:
    print("Invalid API key")
except InsufficientBalanceError as e:
    print(f"Need ${e.required_cents / 100:.2f}")

import AudioPod, { AuthenticationError, InsufficientBalanceError } from 'audiopod';

try {
  const client = new AudioPod({ apiKey: 'ap_...' });
  const result = await client.stems.separate({ url: '...', mode: 'six' });
} catch (error) {
  if (error instanceof AuthenticationError) {
    console.log('Invalid API key');
  } else if (error instanceof InsufficientBalanceError) {
    console.log(`Need $${error.requiredCents / 100}`);
  }
}

Environment Variables

Both SDKs automatically read from the AUDIOPOD_API_KEY environment variable:

export AUDIOPOD_API_KEY="ap_your_api_key"

Next Steps

Python SDK

Complete Python SDK documentation

Node.js SDK

Complete Node.js SDK documentation

API Reference

Raw API endpoint documentation

Get API Key

Generate your API key

​Ready-to-Use SDKs

Python SDK

Node.js SDK

​Quick Comparison

​Installation

​Quick Start

​Available Services

​Error Handling

​Environment Variables

​Next Steps

Python SDK

Node.js SDK

API Reference

Get API Key

Ready-to-Use SDKs

Quick Comparison

Installation

Quick Start

Available Services

Error Handling

Environment Variables

Next Steps