speak-common-errors

# Speak Common Errors ## Overview Diagnose and fix common Speak API errors: authentication failures, audio format issues, rate limits, and session management problems. ## Prerequisites - Completed `speak-install-auth` setup - Valid API credentials configured - ffmpeg installed for audio processing ## Instructions ### Error Code Reference | HTTP | Error Code | Description | Fix | |------|-----------|-------------|-----| | 400 | `audio_format_invalid` | Audio not WAV 16kHz mono | Convert with ffmpeg | | 400 | `audio_too_short` | Recording < 0.5 seconds | Record longer audio | | 400 | `audio_too_long` | Recording > 60 seconds | Trim to under 60s | | 400 | `language_not_supported` | Invalid language code | Use supported codes | | 401 | `invalid_api_key` | Wrong or expired key | Regenerate at dashboard | | 403 | `quota_exceeded` | Monthly limit reached | Upgrade plan or wait | | 404 | `session_not_found` | Invalid session ID | Start a new session | | 408 | `session_expired` | Session timed out | Sessions expire after 30 min | | 413 | `payload_too_large` | Audio file > 25MB | Compress or trim audio | | 429 | `rate_limit_exceeded` | Too many requests | Wait `Retry-After` seconds | ### Quick Diagnostic ```bash # Check API key validity curl -s -o /dev/null -w "%{http_code}" \ -H "Authorization: Bearer $SPEAK_API_KEY" \ https://api.speak.com/v1/languages # 200 = valid, 401 = invalid, 403 = insufficient permissions # Check audio format ffprobe -v quiet -print_format json -sho...