Lista kontrolna przed wdrożeniem

Demo wystarcza jedno zapytanie. Produkt musi przetrwać przekroczenia czasu, zdublowane webhooki, wygasłe linki i wyciek klucza. Przejdź przez tę listę przed startem.

Klucze

• Klucz jest w magazynie sekretów serwera, nigdy w przeglądarce ani w paczce aplikacji.
• Każde środowisko i każda usługa ma własny klucz, który można cofnąć osobno.
• Klucze produkcyjne są ograniczone do używanych modeli i mają dzienny limit wydatków.
• Wiesz, jak wymienić klucz bez przestoju (Uwierzytelnianie).

Tworzenie zadań

• Każde createTask wysyła Idempotency-Key utworzony z twojego ID zlecenia — wygenerowany raz i używany przy każdym ponowieniu.
• Ponawiane są tylko 429, 500, 503 i 50301, z rosnącą przerwą i Retry-After (Błędy).
• 400, 40004 i inne błędy typu „popraw zapytanie” są pokazywane lub logowane, a nie ponawiane.
• Jeśli pokazujesz ceny, najpierw robisz wycenę, przekazujesz quoteId i expectedCredits i obsługujesz 40901.
• O niskim saldzie (40201) dowiaduje się człowiek — alert, e-mail, baner — zanim zauważą to użytkownicy.

Odbiór wyników

• Zadania mają callBackUrl; twój endpoint weryfikuje podpis i odrzuca przestarzałe znaczniki czasu.
• Obsługa webhooka szybko odpowiada 2xx, a pracę wykonuje w tle.
• Zdublowane doręczenia są pomijane na podstawie request_id.
• Okresowy przegląd odczytuje zadania, których webhook nigdy nie dotarł.
• Twój kod traktuje każdy stan inny niż succeeded, failed, expired i canceled jako „jeszcze działa”.

Pliki

• Gotowe pliki są kopiowane do twojego magazynu (albo biblioteki zasobów), zamiast linkować do podpisanego URL, który wygasa po około 20 minutach.
• Zapisujesz taskId, a nie podpisane linki.
• Kod pobierania nie wysyła klucza API pod podpisany URL.
• Pliki referencyjne to publiczne linki HTTPS do samego pliku, przesłane pliki albo zasoby — nie strony udostępniania.

Koszty

• Znasz jednostkę ceny każdego modelu (za obraz, za sekundę, za zapytanie) i ustawienia, które ją podnoszą.
• Podglądy i testy używają najtańszej rozdzielczości i najkrótszego czasu trwania.
• Limit wydatków zatrzyma rozpędzoną pętlę, zanim opróżni saldo.
• Sprawdzasz credits i settled, zamiast zakładać, że pobrano kwotę z wyceny.

Monitoring

• Przy każdym błędzie logujesz request_id, taskId, code i errorCode.
• Obserwujesz odsetek zadań failed dla każdego modelu; nagły wzrost zwykle oznacza zmianę promptu, danych wejściowych albo modelu.
• Mierzysz dla każdego modelu czas od createTask do webhooka i ustawiasz alerty na odchylenia.
• Ktoś w zespole wie, gdzie w konsoli API są logi i strona zużycia.

Treści

PopNow to usługa dla szerokiej publiczności. Modele stosują własne zasady dotyczące treści, a odrzucone przez nie zapytania kończą się content_rejected. Jeśli prompty piszą twoi użytkownicy, wyjaśnij w swoim interfejsie, dlaczego zapytanie zostało odrzucone, zamiast pokazywać surowy błąd, i pozwól je poprawić.