Documentation Index Fetch the complete documentation index at: https://docs.audiopod.ai/llms.txt
Use this file to discover all available pages before exploring further.
Create Your First Key
CLI (Recommended)
Dashboard
Already have an API key? Create more via cURL: 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": ["*"]}'
First time? Follow the Quick Start to register and get your first key.
Go to API Keys
Click Create New API Key
Copy and save your key immediately
Keys are only shown once. Save it securely!
Using Your API Key
Environment Variable (Recommended)
export AUDIOPOD_API_KEY = "ap_your_key_here"
SDK Usage
from audiopod import AudioPod
# Auto-reads from AUDIOPOD_API_KEY env var
client = AudioPod()
# Or pass explicitly
client = AudioPod( api_key = "ap_your_key_here" )
import AudioPod from 'audiopod' ;
// Auto-reads from AUDIOPOD_API_KEY env var
const client = new AudioPod ();
// Or pass explicitly
const client = new AudioPod ({ apiKey: 'ap_your_key_here' });
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=VIDEO_ID" \
-F "mode=six"
Manage Keys via API
# List all keys
curl -s "https://api.audiopod.ai/api/v1/auth/api-keys" \
-H "X-API-Key: $AUDIOPOD_API_KEY " | jq .
# Create new 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": "staging-key",
"scopes": ["*"],
"expires_in_days": 90
}'
# Revoke a key
curl -X DELETE "https://api.audiopod.ai/api/v1/auth/api-keys/KEY_ID" \
-H "X-API-Key: $AUDIOPOD_API_KEY "
Best Practices
Use separate keys per environment
# Development
AUDIOPOD_API_KEY_DEV = ap_dev_...
# Production
AUDIOPOD_API_KEY_PROD = ap_prod_...
Never expose keys in client-side code
API keys should only be used server-side. Create a backend proxy if you need client-side access.
Create a new key → Update your apps → Revoke the old key.
Use expiring keys for temporary access
curl -X POST "https://api.audiopod.ai/api/v1/auth/api-keys" \
-H "X-API-Key: $AUDIOPOD_API_KEY " \
-d '{"name": "temp-key", "expires_in_days": 7}'
Troubleshooting
Error Cause Fix 401 UnauthorizedInvalid or missing key Check X-API-Key header 403 ForbiddenKey revoked or expired Create a new key
Test your key:
curl -s "https://api.audiopod.ai/api/v1/api-wallet/balance" \
-H "X-API-Key: $AUDIOPOD_API_KEY " | jq .balance_usd
Next Steps
Add Funds Top up your wallet to start making API calls
Quick Start Make your first API call