Słownik dewelopera
Praktyczne definicje pomogą wybrać model, obsłużyć stany zadania, zweryfikować wywołania zwrotne, oszacować zużycie i ochronić materiały użytkowników.
Definicja
API, które przyjmuje żądanie wygenerowania mediów, zwraca trwały taskId i kończy pracę poza pierwotnym żądaniem HTTP.
Zapisz taskId przed odpytywaniem albo czekaniem na webhook. queued i running są stanami aktywnymi; succeeded, failed i expired – końcowymi. Przyjętego zadania nie da się anulować.
Powiązana strona →Definicja
Identyfikator tworzony przez klienta, dzięki któremu powtórne wysyłki sprowadzają się do jednego logicznego zadania, zamiast tworzyć podwójną płatną pracę.
Tego samego klucza używaj wyłącznie do tego samego zwalidowanego żądania. Zapisz go razem z zadaniem i przy ponowieniu zwróć pierwotny wynik.
Powiązana strona →Definicja
Wartość kryptograficzna dołączana do wywołania zwrotnego, dzięki której odbiorca sprawdzi, że zdarzenie przyszło z API i nie zostało po drodze zmienione.
Weryfikuj surowe ciało żądania, odrzucaj stare znaczniki czasu i odsiewaj powtórzone eventId, zanim zmienisz stan zadania albo rozliczenia.
Powiązana strona →Definicja
Czytelna maszynowo specyfikacja przyjmowanych pól, typów, limitów, wartości domyślnych i kształtu wyniku modelu.
Formularze i walidację po stronie serwera generuj z opublikowanego schematu, ale zapisuj wersję schematu użytą przy każdym zadaniu.
Powiązana strona →Definicja
Obraz wejściowy, który prowadzi tożsamość, kompozycję, styl albo ruch w żądaniu wygenerowania obrazu lub wideo.
Zbieraj pochodzenie i zgodę, sprawdzaj format i rozmiar, a referencji nie traktuj jak pozwolenia na odtworzenie wizerunku realnej osoby.
Powiązana strona →Definicja
Rozliczenie oparte na zmierzonym zużyciu. Każdy model podaje właściwą jednostkę: obraz, sekundę wyniku, megapiksel, token albo żądanie.
Pokaż jednostkę i wycenę przed wysłaniem; opłaty minimalne, czas trwania i liczba wyników mogą zmienić koszt końcowy.
Powiązana strona →Definicja
Opcja pojedynczych modeli z mniejszą liczbą filtrów treści, która może przetwarzać szerszy zakres treści; etykieta jest informacją o produkcie, a nie zgodą platformy.
Zanim wyślesz żądanie, wprowadź u siebie kontrolę wieku, zgody, realnych osób i jurysdykcji, jakiej wymagają twoi użytkownicy i twoja usługa.
Powiązana strona →Definicja
Proces produktowy, który zapisuje, kto lub co jest przedstawiane, jakie pozwolenie istnieje i która decyzja z zasad dopuściła generowanie.
Dowody zgody trzymaj poza treścią promptu, umożliwiaj jej wycofanie na przyszłość, ogranicz podszywanie się i zachowaj możliwy do audytu zapis decyzji.
Powiązana strona →Sprawdź wejścia modelu, przykłady i aktualny cennik, a przed uruchomieniem zobacz wycenę dla swoich rzeczywistych ustawień.
