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

Getting Started

Account

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

Getting Started

Account

​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