assemblyai-common-errors

# AssemblyAI Common Errors ## Overview Quick reference for the most common AssemblyAI errors across transcription, streaming, and LeMUR APIs with real error messages and solutions. ## Prerequisites - `assemblyai` package installed - API key configured - Access to application logs or console ## Instructions ### Error 1: Authentication Failed ``` Error: Authentication error: Invalid API key Status: 401 ``` **Cause:** API key is missing, invalid, or revoked. **Solution:** ```bash # Verify key is set echo $ASSEMBLYAI_API_KEY # Test directly curl -H "Authorization: $ASSEMBLYAI_API_KEY" \ https://api.assemblyai.com/v2/transcript \ -X GET ``` --- ### Error 2: Transcription Status Error ```json { "status": "error", "error": "Download error: unable to download..." } ``` **Cause:** The `audio` URL is not publicly accessible, has expired, or returned non-audio content. **Solution:** ```typescript // Verify URL is accessible const response = await fetch(audioUrl, { method: 'HEAD' }); console.log('Content-Type:', response.headers.get('content-type')); console.log('Status:', response.status); // Content-Type should be audio/* or video/* // For private files, upload directly const transcript = await client.transcripts.transcribe({ audio: './local-file.mp3', // SDK handles upload }); ``` --- ### Error 3: Could Not Process Audio ```json { "status": "error", "error": "Audio file could not be processed" } ``` **Cause:** Corrupted file, unsupported codec, file too short ...