{"version":1,"generated_at":"2026-05-21","url":"https://audiopod.ai/developers/errors.json","description":"Common API errors developers hit on first integration. Mirrored from the troubleshooting table on /developers.","errors":[{"code":"401 Unauthorized","cause":"Missing or invalid API key. Header expected: Authorization: Bearer ap_…","fix":"Create a key in the dashboard (Settings → API Keys). Free tier includes API access.","docs":"https://docs.audiopod.ai/errors/401"},{"code":"402 Insufficient credits","cause":"Your account ran out of credits for the requested capability.","fix":"Top up via PAYG credit packs, or upgrade your plan. Or wait — free tier resets daily.","docs":"https://docs.audiopod.ai/errors/402"},{"code":"402 PREMIUM_TIER_REQUIRED","cause":"You requested a premium capability variant that your current plan doesn't include.","fix":"Either drop the premium-only parameter (the call succeeds at the standard tier), or upgrade your plan.","docs":"https://docs.audiopod.ai/errors/402#premium"},{"code":"404 voice_not_found","cause":"The voice slug or catalog ID you passed isn't in the public voice catalog (or isn't visible to your account).","fix":"Browse https://audiopod.ai/voices for the live catalog, or call GET /api/v1/voice/public-voice-profiles to list slugs your key can use.","docs":"https://docs.audiopod.ai/errors/404"},{"code":"429 Too many requests","cause":"You exceeded the per-minute request quota for your plan tier.","fix":"Add exponential backoff with the Retry-After header. SDKs handle this automatically. Long-term: upgrade to a higher-throughput plan.","docs":"https://docs.audiopod.ai/errors/429"},{"code":"5xx","cause":"Internal error. The request ID lives in the X-Request-Id response header — quote it when reporting.","fix":"Retry with backoff. If it persists, check https://status.audiopod.ai or email support@audiopod.ai with the request ID.","docs":"https://docs.audiopod.ai/errors/5xx"}]}