ideogram-common-errors

Skill do debugowania błędów Ideogram API. Gdy napotkasz błąd 401, 422, 429 lub inne problemy z generowaniem obrazów, ta umiejętność pomoże Ci zidentyfikować przyczynę i zastosować sprawdzone rozwiązania. Zawiera referencję najczęstszych błędów HTTP, ich przyczyn oraz konkretnych kroków naprawczych — od weryfikacji klucza API po obsługę filtrów bezpieczeństwa. Uruchamiaj frazami typu "ideogram error", "fix ideogram", "ideogram not working" lub "debug ideogram".

1. Upewnij się, że masz skonfigurowany klucz API Ideogram w zmiennej środowiskowej IDEOGRAM_API_KEY oraz dostęp do logów żądań i odpowiedzi. Skill wymaga narzędzi Read, Grep i Bash z obsługą curl.

2. Gdy napotkasz błąd z API Ideogram, wyzwól skill frazą zawierającą słowa takie jak "ideogram error", "fix ideogram", "ideogram not working", "debug ideogram" lub konkretny kod błędu (np. "ideogram 422" lub "ideogram 429").

3. Dla błędu 401 (Unauthorized) — skill podpowie Ci, aby sprawdzić długość klucza API i przetestować autentykację bezpośrednio za pomocą curl. Zwróć uwagę, że Ideogram wymaga nagłówka Api-Key, nie Authorization: Bearer. Sprawdź też, czy w kluczu nie ma białych znaków ani nowych linii, i czy klucz w .env został zaktualizowany po regeneracji w panelu.

4. Dla błędu 422 (Safety Check Failed) — skill wskaże, że treść lub obraz nie przeszły filtry bezpieczeństwa. Usuń z promptu nazwy marek, celebrytów, terminy chronione, zawartość przemocową lub politycznie wrażliwą, a także bezpośrednie odniesienia do rzeczywistych osób. Przeformułuj opis na bardziej neutralny.

5. Przejrzyj sekcję Error Reference w dokumentacji skilla, aby znaleźć kod HTTP Twojego błędu, jego przyczynę i listę typowych błędów. Zastosuj sugerowane poprawki i ponownie przetestuj żądanie.

6. Jeśli problem persystuje, użyj narzędzi Bash i curl dostępnych w skilla, aby ręcznie przetestować endpoint API i przeanalizować pełną odpowiedź serwera — to pomoże Ci zidentyfikować mniej oczywiste problemy z konfiguracją lub danymi wejściowymi.