Najpierw zidentyfikuj krok, w którym wystąpił błąd
Sprawdź status usługi, a następnie rozdziel problemy dostępu do konta, uwierzytelniania API, wykrywania modeli, wnioskowania i płatności. Pojawienie się modelu w katalogu nie oznacza dostępności na żywo: GET /v1/models wyświetla podłączone wdrożenia.
Błąd 503 service_unavailable oznacza, że wymagana usługa nie może przyjąć żądania. Sprawdź status usługi i odniesienie API przed ponowieniem; powtarzanie żądań nie włączy niedostępnej usługi. W przypadku dedykowanego GPU poczekaj na potwierdzone przydzielenie. W przypadku płatności postępuj zgodnie z instrukcjami zamówienia i zapisanym statusem weryfikacji; odświeżenie zamówienia nie dodaje środków.
Pracuj na podstawie odpowiedzi, a nie zgadywania
Zanotuj status HTTP oraz pola code i message błędu. Sprawdź skonfigurowany bazowy adres URL API, dokładny identyfikator modelu i wersję klienta, zanim zmienisz logikę aplikacji.
- 401: sprawdź nagłówek Bearer i czy klucz nie został unieważniony. Nie umieszczaj pełnego klucza w logach.
- 403: wybierz model dozwolony przez listę dozwolonych modeli klucza.
- 400 lub 413: sprawdź JSON, wymagane pola, limit wyjściowy oraz łączny budżet kontekstu wejścia/wyjścia.
- 402: sprawdź, czy konto ma kwalifikujące potwierdzone doładowanie w wysokości co najmniej 100 USD, a następnie sprawdź dostępny kredyt i budżet wybranego klucza; kwalifikujące się konta nie muszą utrzymywać salda 100 USD.
- 429: postępuj zgodnie z nagłówkiem Retry-After, jeśli został podany, stosuj ograniczone ponowienia i sprawdź obowiązujące limity usług; nie ma dziennego bezpłatnego limitu próbnego.
- 502 lub 503: sprawdź dostępność i komunikat o błędzie przed ograniczonym ponowieniem.
Przewodnik po błędach i limity wyjaśniają ścieżki odzyskiwania. Nowe żądanie może utworzyć nową pracę; nie zakładaj, że ponowienia po stronie klienta są deduplikowane.
Traktuj przerwane strumienie i oczekujące środki razem
Zamknięcie karty przeglądarki, limit czasu lub przerwany strumień nie dowodzi, że generowanie się zatrzymało. Zapisz identyfikator odpowiedzi i ostatnią ramkę użycia, jeśli została odebrana. Ostatnia ramka użycia może nadejść po finish_reason wyboru; fragment sieciowy niekoniecznie jest kompletnym zdarzeniem.
Błąd 409 pending_reconciliation lub błąd upstream po wysłaniu może pozostawić środki zarezerwowane do czasu uzyskania autorytatywnych danych o użyciu. Unikaj wysyłania zduplikowanych żądań w celu zwolnienia blokady. Porównaj czas UTC, model i nazwę klucza z użyciem w konsoli i zachowaj szczegóły żądania do uzgodnienia. Czasy zwolnienia nie są gwarantowane.
W przypadku problemu z płatnością zanotuj odwołanie do zamówienia, aktywa, sieć, kwotę i widoczny status. Nigdy nie wysyłaj kolejnej płatności tylko dlatego, że pierwsza jest w toku. Wypłaty do portfela są obecnie niedostępne. Anulowanie opłaconego zamówienia GPU przed aktywacją zwraca płatność do salda konta WeightsAPI; nie przenosi środków do portfela.
Przygotuj dowody, które ktoś może odtworzyć
Przydatny raport obejmuje operację, znacznik czasu UTC, ścieżkę punktu końcowego, identyfikator modelu, zestaw SDK lub integrację i wersję, ustawienie strumieniowania, limit tokenów wyjściowych, status/błąd, oczekiwany wynik i faktyczny wynik. Dołącz referencję odpowiedzi lub transakcji tylko wtedy, gdy jest dostępna; brama nie udostępnia obecnie identyfikatora pomocy technicznej przy każdym błędzie.
Dodaj najmniejszy syntetyczny przykład, który odtwarza problem. Zastąp prawdziwe rozmowy, rekordy klientów i prywatne dokumenty wymyślonym tekstem. Podaj istotne liczby ponowień oraz czy problem powtarza się między żądaniami. Zrzuty ekranu powinny pokazywać błąd i kontekst po usunięciu poświadczeń, sald lub identyfikatorów, których nie zamierzasz udostępniać.
W przypadku zamówienia dedykowanego GPU podaj numer referencyjny zamówienia, konfigurację oraz widoczny status płatności lub provisioning. Zamówienie oczekujące nie jest aktywną maszyną.
Nie ujawniaj poświadczeń ani treści klientów
Nigdy nie podawaj sekretu API, nagłówka Authorization, ciasteczka sesyjnego, prywatnego klucza portfela, frazy odzyskiwania ani pełnego pliku środowiskowego. Nazwa klucza lub celowo skrócony prefiks wystarczą do rozróżnienia aplikacji. Publiczne referencje transakcji mogą nadal łączyć aktywność z portfelem; udostępniaj tylko to, czego wymaga dochodzenie.
Jeśli klucz został ujawniony, utwórz nowy, zaktualizuj aplikację i unieważnij stary klucz. Unieważnienie blokuje nowe przyjęcia; wcześniej przyjęte żądania rozliczają się normalnie. Zobacz uwierzytelnianie w sprawie obsługi kluczy.
Zapisz swój raport i sprawdź dane kontaktowe
Skopiuj i przejrzyj swój raport, a następnie zachowaj go wraz z odpowiednim odwołaniem do żądania lub zamówienia. Kopiowanie nie powoduje przesłania zgłoszenia. Oficjalne kontakty pomocy technicznej i godziny pracy nie są opublikowane; użyj tylko potwierdzonego kanału, aby udostępnić raport.
Cele czasu odpowiedzi, kontakty eskalacji i rekompensaty w postaci środków na koncie nie zostały ustalone. Nie umieszczaj w raporcie poświadczeń ani wrażliwych treści klienta.