Kredyty i rozliczenia

Jak wywołania API zużywają kredyty, jak działają blokada i ostateczne obciążenie, wycena przed uruchomieniem, saldo, zużycie i limity wydatków.

API korzysta z tych samych kredytów co popnow.ai. Nie ma osobnego planu API, subskrypcji ani minimalnej kwoty: kup pakiet kredytów, gdy potrzebujesz więcej, a darmowe kredyty z rejestracji działają także tutaj.

1 kredyt = 0,01 USD według stawki bazowej. Większe pakiety zawierają kredyty bonusowe, więc każdy kredyt kosztuje cię trochę mniej.
Ceny zależą od modelu i opcji — za obraz, za sekundę wideo lub audio, za zapytanie albo za 1000 znaków syntezy mowy. Strona każdego modelu je wymienia.
Odpowiedzi podają każdą kwotę dwa razy: w pełnych kredytach (credits, maxCredits, availableCredits …) i jako ciąg w dolarach (cost, maxCharge, available …). Korzystaj z pól w kredytach; ciągi w dolarach są dla księgowości.

Jak rozliczane jest zadanie

hold

settlerelease

Kredyty są blokowane przy przyjęciu zadania i rozliczane tylko raz: według faktycznego zużycia albo zwracane w całości.

Blokada. Gdy createTask przyjmuje zadanie, z twojego salda odkładana jest najwyższa cena, jaką może ono osiągnąć (estimatedCredits). Zablokowanych kredytów nie da się wydać dwa razy, ale nie są jeszcze pobrane.
Rozliczenie albo zwolnienie. Gdy zadanie się kończy:
- succeeded → płacisz za faktyczne zużycie, zaokrąglone w górę do pełnych kredytów i nigdy więcej niż blokada. Reszta wraca na saldo.
- failed albo expired → cała blokada jest zwalniana. Nic nie płacisz.

Rekord zadania pokazuje, na jakim jest etapie: dopóki settled ma wartość false, credits to blokada; gdy settled ma true, credits to ostateczne obciążenie.

Kilka modeli pobiera opłatę za zapytanie, które ich twórca odrzucił z powodu treści. Wtedy strona modelu o tym mówi; we wszystkich innych przypadkach niepowodzenie jest darmowe.

Sytuacja	Płatne?
`createTask` odrzucone (`400`, `402`, `403`, `429`, `50301` …)	Nie — bez zadania, bez blokady
Zadanie `succeeded`	Tak, faktyczna kwota, nie więcej niż blokada
Zadanie `failed` albo `expired`	Nie, z wyjątkiem opisanej wyżej odmowy z powodu treści
Połączenie zerwało się po wysłaniu	Nie wiadomo, dopóki nie sprawdzisz — wyślij ponownie z tym samym `Idempotency-Key`, by znaleźć zadanie
Odczyt zadań, modeli, salda lub zużycia	Nigdy

Najpierw zapytaj o cenę

POST /api/v1/jobs/quote przyjmuje dokładnie tę treść, którą wysłałbyś do createTask, i zwraca cenę, nic nie tworząc ani nie blokując:

curl -X POST "https://api.popnow.ai/api/v1/jobs/quote" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "alibaba/wan-3.0/image-to-video", "input": {"image_url": "https://media.popnow.ai/movie/lighthouse.webp", "resolution": "720p", "duration_seconds": 5}}'

{
  "code": 200,
  "msg": "success",
  "data": {
    "quoteId": "q_…",
    "model": "alibaba/wan-3.0/image-to-video",
    "maxCredits": 68,
    "expectedCredits": 68,
    "estimatedCost": "0.68",
    "maxCharge": "0.68",
    "currency": "USD",
    "quantity": "5",
    "unit": "per_second",
    "expiresAt": "2026-10-16T09:25:00Z"
  },
  "request_id": "req_…"
}

maxCredits to najwięcej, ile może kosztować zapytanie — kwota, która zostanie zablokowana. expectedCredits to zwykły koszt; różnią się tylko wtedy, gdy ostateczna opłata zależy od wyniku, np. od rzeczywistej długości klipu.

Żeby cena nie zmieniła się między pokazaniem jej użytkownikowi a uruchomieniem, przekaż quoteId i expectedCredits (pokazane maxCredits) do createTask w ciągu pięciu minut. Jeśli coś się zmieniło, createTask odpowie 40901 i niczego nie zablokuje; wyceń ponownie.

Saldo

curl "https://api.popnow.ai/api/v1/chat/credit" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

availableCredits to to, z czego mogą korzystać nowe zadania, heldCredits to kwota odłożona dla trwających zadań, a totalCredits to suma obu (available, held i total podają te same kwoty w dolarach). Nazwa ścieżki jest historyczna i nie ma nic wspólnego z czatem. Gdy dostępne saldo nie pokrywa blokady nowego zadania, createTask zwraca 40201.

Zużycie

GET /api/v1/usage?from=2026-10-01&to=2026-10-16 zwraca dla klucza, którym wywołujesz, liczbę zadań, ile się udało, a ile nie, i ile kosztowały w kredytach — łącznie (totalCredits), dziennie i według modelu. Daty są w UTC, to jest wyłączne, a zakres to najwyżej 92 dni. Liczą się tylko rozliczone obciążenia, więc suma dnia może się jeszcze zmienić, gdy kończą się spóźnione zadania. Ten raport ma limit 30 zapytań na minutę; dla całego konta użyj strony zużycia w konsoli API.

Limity wydatków

Każdy klucz może mieć limit dzienny, miesięczny i całkowity, ustawiany w konsoli API i pokazywany w kredytach. Zapytanie, które przekroczyłoby limit, zwraca 40202 i niczego nie blokuje. Limity dzienne zerują się o 00:00 UTC, miesięczne pierwszego dnia miesiąca o 00:00 UTC, a całkowity nigdy. Bez ustawienia klucze nie mają limitów.

Zakup kredytów i zwroty

Kredyty kupuje się na stronie, nie przez API. Pakiety i ceny są na stronie cennika; zasady zwrotów wyjaśniają, co i kiedy można zwrócić.