Skorzystaj z tego przewodnika, by zdiagnozować i rozwiązać typowe problemy, które pojawiają się, wywołujesz interfejs Gemini API. Jeśli napotkasz problemy z kluczem interfejsu API, upewnij się, że masz klucz interfejsu API zgodnie z przewodnikiem po konfiguracji klucza interfejsu API.
Kody błędów
W tabeli poniżej znajdziesz typowe kody błędów, które możesz napotkać, wyjaśnienia ich przyczyn i sposoby rozwiązywania problemów:
| Kod HTTP | Status | Opis | Rozwiązanie |
| 400 | NIEPRAWIDŁOWY_ARG | Treść żądania jest nieprawidłowa. | Format żądania, przykłady i obsługiwane wersje znajdziesz w dokumentacji interfejsu API. Korzystanie z funkcji z nowszej wersji interfejsu API ze starszym punktem końcowym może powodować błędy. |
| 400 | FAILED_PRECONDITION | Poziom bezpłatny Gemini API nie jest dostępny w Twoim kraju. Włącz płatności w swoim projekcie w Google AI Studio. | Aby korzystać z Gemini API, musisz skonfigurować płatny abonament za pomocą Google AI Studio. |
| 403 | PERMISSION_DENIED | Twój klucz interfejsu API nie ma wymaganych uprawnień. | Sprawdź, czy Twój klucz interfejsu API jest ustawiony i ma odpowiednie uprawnienia dostępu. |
| 404 | NOT_FOUND | Nie znaleziono żądanego zasobu. | Sprawdź, czy wszystkie parametry w żądaniu są prawidłowe w Twojej wersji interfejsu API. |
| 429 | RESOURCE_EXHAUSTED | Przekroczono limit liczby żądań. | Sprawdź, czy nie przekraczasz limitu liczby żądań modelu. W razie potrzeby poproś o zwiększenie limitu. |
| 500 | DO UŻYTKU WEWNĘTRZNEGO | Po stronie Google wystąpił nieoczekiwany błąd. | Zaczekaj chwilę i spróbuj ponownie. Jeśli po ponownej próbie problem nie ustąpi, zgłoś go za pomocą przycisku Prześlij opinię w Google AI Studio. |
| 503 | PRODUKT NIEDOSTĘPNY | Usługa może być tymczasowo przeciążona lub wyłączona. | Zaczekaj chwilę i spróbuj ponownie. Jeśli po ponownej próbie problem nie ustąpi, zgłoś go za pomocą przycisku Prześlij opinię w Google AI Studio. |
Sprawdź wywołania interfejsu API pod kątem błędów parametrów modelu
Upewnij się, że parametry modelu nie przekraczają tych wartości:
| Parametr modelu | Wartości (zakres) |
| Liczba kandydatów | 1–8 (całkowita) |
| Temperatura | 0,0–1,0 |
| Maksymalna liczba tokenów wyjściowych |
Używaj
get_model (Python)
aby określić maksymalną liczbę tokenów dla używanego modelu.
|
| TopP | 0,0–1,0 |
Oprócz sprawdzenia wartości parametrów upewnij się, że używasz prawidłowego
Wersja interfejsu API (np. /v1 lub /v1beta) i
który obsługuje potrzebne funkcje. Jeśli na przykład funkcja jest w wersji beta,
będzie dostępny tylko w wersji interfejsu API /v1beta.
Sprawdź, czy masz właściwy model
Upewnij się, że używasz obsługiwanego modelu wymienionego w stronie modeli.
Problemy dotyczące bezpieczeństwa
Jeśli zauważysz, że prośba została zablokowana z powodu ustawienia bezpieczeństwa w wywołaniu interfejsu API, i sprawdzić prompt pod kątem filtrów ustawionych w wywołaniu interfejsu API.
Jeśli widzisz BlockedReason.OTHER, zapytanie lub odpowiedź mogą naruszać warunki
usługi lub w inny sposób nie są obsługiwane.
Popraw dane wyjściowe modelu
Aby uzyskać wyższej jakości dane wyjściowe modelu, spróbuj napisać bardziej uporządkowane prompty. wprowadzenie do projektowania promptów kilka podstawowych koncepcji, strategii i sprawdzonych metod.
Jeśli masz setki przykładów dobrych par wejścia-wyjścia, możesz rozważ dostrajanie modelu.
Limity tokenów
Zapoznaj się z przewodnikiem dotyczącym tokenów, aby dowiedzieć się, jak , aby liczyć tokeny i ich limity.
Znane problemy
- Interfejs API obsługuje tylko język angielski. Wysyłanie promptów w różnych językach może generować nieoczekiwane lub nawet zablokowane odpowiedzi. Zobacz dostępne .
Zgłoś błąd
Dołącz do dyskusji na forum dla programistów AI od Google .