Kredyty
Jak działa rezerwacja, zużycie i zwrot kredytów API przy generowaniu treści.
Qamera AI API wykorzystuje system kredytowy do rozliczania generowania treści. Zrozumienie przepływu kredytów przez API pomaga zarządzać kosztami i obsługiwać przypadki brzegowe.
Endpointy bezpłatne vs. płatne
| Metoda | Kredyty | Przykłady |
|---|---|---|
| GET | Bezpłatne | Lista produktów, pobieranie statusu zamówienia, pobieranie wyników zadań. |
| POST | Zużywają kredyty | Tworzenie zamówień na packshoty, uruchamianie sesji zdjęciowych, generowanie wideo. |
Operacje odczytu nigdy nie zużywają kredytów. Tylko zapytania POST uruchamiające generowanie treści obciążają saldo konta.
Przepływ rezerwacji kredytów
Gdy wysyłasz zapytanie POST generujące treści, kredyty przechodzą przez trzy etapy:
1. Rezerwacja
Przed rozpoczęciem przetwarzania API rezerwuje wymaganą liczbę kredytów z salda konta. Zapewnia to, że konto jest w stanie pokryć koszt żądanego generowania.
Jeśli saldo jest niewystarczające, zapytanie zostaje natychmiast odrzucone z odpowiedzią 402 Payment Required:
{
"error": "Insufficient credits. Required: 5, available: 2."
}
2. Przetwarzanie
Zadanie generowania jest w toku. Kredyty pozostają w stanie zarezerwowanym — są odjęte od dostępnego salda, ale jeszcze nie zostały trwale zużyte.
3. Rozliczenie
Po zakończeniu przetwarzania:
- W przypadku sukcesu — Zarezerwowane kredyty zostają trwale zużyte.
- W przypadku niepowodzenia — Zarezerwowane kredyty są automatycznie zwracane na saldo konta.
Nie musisz podejmować żadnych działań w celu uzyskania zwrotu. System obsługuje to automatycznie.
Śledzenie zużycia kredytów
Odpowiedzi POST uruchamiające generowanie zawierają pola związane z kredytami:
{
"orderId": "order_abc123",
"reservationId": "res_xyz789",
"creditsReserved": 5,
"status": "processing"
}
| Pole | Opis |
|---|---|
orderId | Unikalny identyfikator zamówienia generowania treści. |
reservationId | Identyfikator rezerwacji kredytów powiązanej z tym zamówieniem. |
creditsReserved | Liczba zarezerwowanych kredytów dla tego zapytania. |
Użyj orderId do odpytywania endpointu statusu zamówienia i potwierdzenia, czy kredyty zostały zużyte, czy zwrócone.
Sprawdzanie salda
Przed wysłaniem zapytań generowania sprawdź, czy konto ma wystarczającą liczbę kredytów. Bieżące saldo kredytów możesz sprawdzić w sekcji Kredyty swojego zespołowego workspace lub uwzględnić oczekiwany koszt w logice integracji.
Cennik
Liczba kredytów zużywanych na zapytanie zależy od typu treści i konfiguracji cenowej konta. Różne typy generowania (packshoty, sesje zdjęciowe, wideo) mają różne koszty kredytowe. Szczegółowe ceny znajdziesz w informacjach o swoim planie subskrypcyjnym.
Najlepsze praktyki
- Sprawdzaj przed generowaniem — Jeśli Twój przepływ pracy obejmuje generowanie wsadowe, sprawdź, czy saldo kredytów pokrywa całą partię przed rozpoczęciem.
- Obsługuj 402 z gracją — Zbuduj integrację tak, aby wykrywała odpowiedzi o niewystarczających kredytach i powiadamiała zespół, zanim zablokują przepływ pracy.
- Monitoruj rezerwacje — Używaj
orderIdireservationIddo śledzenia trwających generowań i uzgadniania zużycia kredytów. - Ufaj automatycznym zwrotom — Nieudane zadania zwracają kredyty bez żadnej interwencji. Nie ma potrzeby budowania ręcznej logiki zwrotów.