API Keys

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.

Using Your API Key

Environment Variable (Recommended)

export AUDIOPOD_API_KEY="ap_your_key_here"

SDK Usage

Python
Node.js
cURL

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.

Rotate keys regularly

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 Unauthorized`	Invalid or missing key	Check `X-API-Key` header
`403 Forbidden`	Key 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

Create Your First Key

Using Your API Key

Environment Variable (Recommended)

SDK Usage

Manage Keys via API

Best Practices

Troubleshooting

Next Steps

Add Funds

Quick Start

​Create Your First Key

​Using Your API Key

​Environment Variable (Recommended)

​SDK Usage

​Manage Keys via API

​Best Practices

​Troubleshooting

​Next Steps

Add Funds

Quick Start

Create Your First Key

Using Your API Key

Environment Variable (Recommended)

SDK Usage

Manage Keys via API

Best Practices

Troubleshooting

Next Steps