Pro API: limity, kody błędów i dobre praktyki

Limity

Każdy klucz ma trzy: jednoczesne renderowania (domyślnie 2), zgłoszenia na minutę (domyślnie 60) oraz, jeśli ustawisz, dzienny limit kredytów.

Po przekroczeniu limitu odpowiedź to 429 z nagłówkiem Retry-After podanym w sekundach. Odrzucone wywołanie nic nie kosztuje. Dzień użyty do obliczania limitów to dzień UTC.

Nasza własna karta jest współdzielona z użytkownikami aplikacji. Gdy jest zajęta, twoje renderowania trafiają na wynajęte GPU, w tej samej cenie i przez to samo API, z kilkudziesięcioma sekundami dłużej przy starcie.

Kody błędów

Kod	error	Co oznacza i co zrobić
400	champ prompt requis	Dodaj prompt.
400	contenu_interdit	Filtr treści odrzucił prompt.
400	image_requise, inpaint_images_requises	Tryb wymaga image_b64, a dla inpaint również mask_b64.
401	cle_requise, cle_invalide	Brakujący nagłówek lub nieznany klucz.
402	credits_insuffisants	Niewystarczające saldo na to renderowanie (podany jest cost). Doładuj konto na stronie.
403	cle_desactivee, cle_revoquee, cle_expiree	Klucz wyłączony, unieważniony lub wygasły: utwórz nowy w aplikacji.
403	licence_revoquee, licence_non_pro	Licencja unieważniona lub konto bez statusu Pro.
403	portee_manquante	Klucz nie ma wymaganego uprawnienia, wymienionego w portee.
403	lora_inconnu	Postać, która nie należy do tego konta.
404	media_indisponible	Plik zniknął: wyślij ponownie.
413	image_trop_lourde	Obraz źródłowy lub maska przekracza 12 MB po zdekodowaniu.
429	trop_de_rendus_simultanes, cadence_minute, plafond_jour	Osiągnięto limit, sprawdź Retry-After.
429	plafond_credits_jour	Osiągnięto dzienny limit kredytów klucza (plafond, depense, cout).
502	soumission_echouee, statut_echoue	Incydent po stronie renderowania: spróbuj ponownie za kilka sekund.
503	licence_inverifiable	Konta nie można teraz zweryfikować: spróbuj ponownie za minutę.

Nazwy błędów to dokładne ciągi znaków zwracane przez API. Dopasowuj je, a nie treść komunikatu, który może ulec zmianie.

Dobre praktyki

• Odpytuj co 3 sekundy, nie częściej. Kolejka jest współdzielona i bombardowanie jej nikomu nie pomaga.
• Pobierz plik od razu, gdy status zmieni się na completed. Plik nie jest archiwizowany.
• Pisz prompty po angielsku, a w przypadku wideo opisuj ruch, a nie nieruchomy kadr.
• Jeden klucz na jedno zastosowanie i dzienny limit kredytów na każdym kluczu działającym na serwerze. Wyciek klucza z limitem kosztuje cię jeden dzień, nie całe saldo.
• Traktuj 429 jako normalną sytuację, a nie jako błąd: poczekaj na Retry-After i kontynuuj.

Prompty są logowane po naszej stronie, podobnie jak w aplikacji, dla celów bezpieczeństwa.