| name | speak-common-errors |
| description | Diagnose and fix common Speak API errors: authentication failures, audio format issues, rate limits, and session management problems.
Use when implementing common errors features,
or troubleshooting Speak language learning integration issues.
Trigger with phrases like "speak common errors", "speak common errors".
|
| allowed-tools | Read, Write, Edit, Bash(npm:*), Bash(curl:*), Grep |
| version | 1.14.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| tags | ["saas","speak","debugging"] |
| compatibility | Designed for Claude Code, also compatible with Codex and OpenClaw |
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
curl -s -o /dev/null -w "%{http_code}" \
-H "Authorization: Bearer $SPEAK_API_KEY" \
https://api.speak.com/v1/languages
ffprobe -v quiet -print_format json -show_streams recording.wav \
| python3 -c
