deepgram-common-errors

Umiejętność do debugowania błędów Deepgram API. Pomaga zidentyfikować i rozwiązać problemy z transkrypcją audio, błędy autoryzacji, nieprawidłowe formaty plików oraz problemy z integracją. Zawiera gotowe komendy diagnostyczne, referencję kodów HTTP (400, 401, 403, 404, 408) i wskazówki dotyczące konfiguracji klucza API. Działa z Claude Code, Codex i OpenClaw — wystarczy wyzwolić frazami typu "deepgram error", "transcription failed" lub "fix deepgram".

1. Upewnij się, że masz skonfigurowany klucz API Deepgram w zmiennej środowiskowej DEEPGRAM_API_KEY oraz dostęp do narzędzi curl i bash.

2. Wyzwól umiejętność frazą zawierającą słowa kluczowe, takie jak "deepgram error", "deepgram not working", "fix deepgram", "deepgram troubleshoot", "transcription failed" lub "deepgram 401".

3. Uruchom szybką diagnostykę — narzędzie wyśle żądanie curl do endpointu Deepgram, aby sprawdzić ważność klucza API i połączenie z usługą.

4. Przeanalizuj odpowiedź HTTP. Jeśli otrzymasz kod 401, klucz jest nieprawidłowy lub wygasł — wygeneruj nowy w konsoli Deepgram. Kod 403 oznacza brak uprawnień "listen" — utwórz klucz z odpowiednim zakresem. Kod 400 wskazuje na błąd w formacie audio lub parametrach zapytania.

5. W przypadku błędów transkrypcji sprawdź format pliku audio (obsługiwane formaty: WAV, MP3, FLAC, OGG) i rozmiar — jeśli plik jest zbyt duży dla synchronicznego przetwarzania, użyj callback zamiast czekać na odpowiedź.

6. Jeśli problem persystuje, sprawdź logi aplikacji i powtórz diagnostykę z poprawionymi parametrami.