Dlaczego API obrazów rozliczamy w monetach (i dlaczego samo zwraca pieniądze)

Budując publiczne API na bazie Fellowi Images, musieliśmy podjąć kilka decyzji, które w dokumentacji nie występują jako funkcje - widać je raczej jako brak problemów. To jest rozumowanie, które za nimi stoi: dlaczego rozliczenie idzie w monetach, co się dzieje, gdy generacja się nie udaje, i dlaczego kilka liczb w dokumentacji (limity zapytań, dni przechowywania) znaczy mniej, niż się na pierwszy rzut oka wydaje.

Monety, a nie abonament

Generowanie obrazu ma realny, zmienny koszt przy każdym wywołaniu. Płaski miesięczny abonament albo przepłaca ktoś, kto generuje pięć obrazów miesięcznie, albo dopłacamy do kogoś, kto generuje pięćset - nie ma liczby stanowisk ani puli zapytań, która czysto na to się przekłada. Monety sprawiają, że koszt idzie prosto za użyciem: płacisz dokładnie za to, co naprawdę wygenerujesz, i nic ponad to. Monety nigdy nie tracą ważności i nie ma czego anulować, więc nie ma też cyklu rozliczeniowego, którego można nie dopilnować - kupujesz pakiet, kiedy go potrzebujesz, a do tego czasu po prostu leży w portfelu.

Nieudana generacja zwraca się sama

Jeśli generacja przekroczy czas albo zostanie odrzucona, zanim powstanie obraz, wydane na nią monety wracają automatycznie i natychmiast. To nie jest zgłoszenie, które musisz założyć w supporcie - to własność systemu: nigdy nie płacisz za obraz, którego nie dostałeś. Traktujemy to jako gwarancję niezawodności, nie jako uprzejmość.

Każde niepowodzenie sprowadza się do dokładnie jednego z czterech kodów, świadomie krótkiej listy:

• TIMEOUT - generacja trwała zbyt długo i została przerwana.
• MODERATION_REJECTED - zapytanie naruszało zasady dotyczące treści.
• VENDOR_ERROR - coś zawiodło wyżej, po stronie generowania.
• UNKNOWN - prawdziwy worek na wszystko, co nie pasuje do pozostałych trzech.

Mały, zamknięty zestaw kodów to decyzja celowa - na czymś takim naprawdę da się napisać instrukcję switch, zamiast dopasowywać wzorce do dowolnie sformułowanych komunikatów błędu, które mogą się zmienić pod tobą.

Obrazy wygasają po 30 dniach

Bajty wygenerowanego obrazu przechowujemy 30 dni. Po tym czasie wpis w historii generacji nadal istnieje - endpoint listy wciąż pokazuje, że to się stało, kiedy i ile kosztowało - ale pobranie samej treści obrazu zwróci HTTP 410 Gone. To zwykły, jawny kompromis kosztów przechowywania: jeśli chcesz zachować obraz dłużej niż 30 dni, pobierz go i przechowaj u siebie. Nigdy nie usuwamy po cichu zapisu o generacji, tylko bajty.

Limity zapytań nie są prawdziwym sufitem

Minutowy limit zapytań na twoim kluczu API (domyślnie 20 zapytań na minutę na generowanie i 120 na odczyty) istnieje, żeby wygaszać nadużycia, a nie żeby faktycznie decydować, ile obrazów możesz zrobić. Prawdziwym sufitem jest twoje saldo Fellowi Coins - jeśli masz monety, możesz je wydać, do wysokości tego limitu. Jeśli chcesz budżetu ciaśniejszego niż twoje saldo, klucz może dodatkowo nieść opcjonalny dzienny limit monet, który ustawiasz sam - dla własnej kontroli kosztów, nie naszej.

Klucze, których nie odzyskasz

Klucz API pokazujemy ci dokładnie raz, przy tworzeniu. Później po naszej stronie zostaje tylko wartość zahaszowana i krótki podglądowy fragment - to samo podejście, które stosujemy do każdego innego sekretu w produkcie. Jeśli zgubisz klucz, generujesz nowy; nie ma procedury odzyskiwania, bo po naszej stronie nie ma niczego, co byłoby w stanie go odtworzyć.

Ten sam portfel, ta sama cena

API i aplikacja webowaczerpią z dokładnie tego samego salda Fellowi Coins, po dokładnie tej samej cenie za poziom jakości - 40 monet za Standard, 60 za wysoką jakość. Nie ma osobnego “cennika dla API”. To celowe: twój koszt jest przewidywalny niezależnie od tego, którymi drzwiami generujesz.

Konkretne formaty zapytań i odpowiedzi oraz działające przykłady kodu znajdziesz w naszym szybkim starcie z API, albo przejdź od razu do API Console, żeby utworzyć klucz.