Saldo API i zwroty
Osobne saldo API w USD, ceny modeli, zwalnianie blokad zadań i pomoc w sprawie zwrotów płatności za API.
API PopNow ma własne saldo w USD, oddzielne od kredytów strony. Wywołania z kluczem API, połączenia MCP z kluczem API i uruchomienia w Playground zużywają USD z salda API. MCP połączone przez OAuth nadal zużywa kredyty strony. Ten sam model z tymi samymi ustawieniami ma tę samą cenę w API i na stronie; sald nie można między sobą przenosić ani używać zamiennie.
Ta strona wyjaśnia doładowania API, ceny i zwalnianie blokad. Blokady pojedynczych zadań, wyceny i limity opisują rozliczenia API.
Saldo API w minutę
- Zaczyna się od 0 USD. Doładuj API w rozliczeniach API przed płatnymi wywołaniami, także testami w Playground.
- Oddzielne doładowania. Pakiety kredytów strony, bonusy i nagrody nie opłacają wywołań API. Środki API nie opłacają generowania na stronie ani wywołań MCP przez OAuth.
- Wyceń przed uruchomieniem.
jobs/quotezwracaexpectedChargeUsdimaxChargeUsdjako ciągi dziesiętne w USD, nie uruchamiając zadania. - Odczytaj rozliczoną kwotę.
costUsdzadania to ostateczne obciążenie w USD, gdysettledma wartośćtrue. Nieudane lub wygasłe zadania automatycznie zwalniają blokady, z uwzględnieniem ewentualnej opłaty danego modelu za odmowę z powodu treści.
Skąd biorą się środki API
Doładowania API i historię płatności znajdziesz w rozliczeniach API, korzystając z aktualnie dostępnych tam opcji płatności. Klucze twórz i zarządzaj nimi osobno na stronie kluczy API.
Bonusy do pakietów kredytów strony, nagrody za zaproszenia i inne kredyty przyznawane na stronie nie zasilają salda API. Wielkości pakietów strony, terminy zwrotów i zasady wygasania nie są warunkami doładowań API.
Z którego salda pobierana jest opłata
Użyte poświadczenie i miejsce wywołania decydują o saldzie:
| Wywołanie lub miejsce | Używane saldo |
|---|---|
REST lub zgodne API z kluczem sk-popnow- | USD w API |
| Playground na stronie modelu API | USD w API |
| MCP uwierzytelnione kluczem API | USD w API |
| Generowanie na stronie lub MCP połączone przez OAuth | Kredyty strony |
Doładowanie jednego salda nie uzupełnia drugiego. Jeśli saldo API nie wystarcza na blokadę zapytania, doładuj API zamiast kupować kredyty strony.
Jak wyceniane jest generowanie
Każdy model ma własny cennik zależny od opcji: za obraz, sekundę wideo lub audio, utwór albo 1000 znaków syntezy mowy. Cena zależy od rozdzielczości, długości, poziomu jakości, a w niektórych modelach także od liczby przesłanych plików referencyjnych.
Przykładowe ceny API w USD:
| Model | Co otrzymujesz | USD |
|---|---|---|
| Z-Image Turbo | Jeden obraz | $0.01 |
| Nano Banana 2.1 | Jeden obraz w 1K / 2K / 4K | $0.048 / $0.072 / $0.162 |
| Seedream 5.0 Pro | Jeden obraz w 1K / 2K | $0.036 / $0.072 |
| MiniMax H3 | Zdjęcie na wideo, 768p, 5 sekund | $0.185 |
| Suno v6 | Jeden utwór | $0.072 |
| Background Remover | Jeden przezroczysty PNG | $0.0048 |
| Image Upscaler | Jedno zdjęcie w zwiększonej rozdzielczości | $0.012 |
Strona Modele prowadzi do dokumentacji poszczególnych modeli. Pobierz aktualną wycenę dla swoich ustawień i zachowuj precyzję dziesiętną USD (do dziewięciu miejsc po przecinku); nie zaokrąglaj opłat API do pełnych kredytów. Playground na stronach API zużywa to samo saldo API w USD.
Zapytaj o dokładną kwotę przed uruchomieniem:
curl -X POST "https://api.popnow.ai/api/v1/jobs/quote" \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "minimax/h3/image-to-video", "input": {"image_url": "https://media.popnow.ai/movie/lighthouse.webp", "prompt": "The waves roll in slowly", "duration_seconds": 5}}'import os, requests
quote = requests.post(
"https://api.popnow.ai/api/v1/jobs/quote",
headers={"Authorization": f"Bearer {os.environ['POPNOW_API_KEY']}"},
json={
"model": "minimax/h3/image-to-video",
"input": {"image_url": "https://media.popnow.ai/movie/lighthouse.webp", "prompt": "The waves roll in slowly", "duration_seconds": 5},
},
timeout=30,
).json()["data"]
print(quote["maxChargeUsd"], "USD at most,", quote["expectedChargeUsd"], "USD estimated")const res = await fetch('https://api.popnow.ai/api/v1/jobs/quote', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.POPNOW_API_KEY}`, 'Content-Type': 'application/json' },
body: JSON.stringify({
model: 'minimax/h3/image-to-video',
input: { image_url: 'https://media.popnow.ai/movie/lighthouse.webp', prompt: 'The waves roll in slowly', duration_seconds: 5 },
}),
});
const { data } = await res.json();
console.log(`${data.maxChargeUsd} USD at most, ${data.expectedChargeUsd} USD estimated`);Co się dzieje, gdy zadanie się nie powiedzie
Gdy zadanie zostaje przyjęte, jego najwyższa możliwa cena w USD jest odkładana z salda API jako blokada. Po zakończeniu:
| Wynik | Ile płacisz |
|---|---|
succeeded | Faktyczne obciążenie w USD, nigdy więcej niż blokada; niewykorzystana kwota jest zwalniana |
failed lub expired | Nic; blokada jest zwalniana, z wyjątkiem ewentualnej opłaty danego modelu za odmowę z powodu treści |
| Odrzucone ze względu na treść | Nic, z wyjątkiem modeli, których strona informuje o opłacie za odmowę |
Odrzucone przed rozpoczęciem (400, 402, 403, 429 …) | Nic; bez zadania i bez blokady |
Zwolnienie blokady przywraca dostępne środki API; nie oznacza zwrotu płatności na konto bankowe lub kartę. Ostateczną kwotę w USD odczytaj z costUsd razem z settled w rekordzie zadania. Zobacz Rozliczenia API.
Zwroty płatności za API
W sprawie doładowania API lub zwrotu płatności otwórz rozliczenia API albo skontaktuj się ze wsparciem. Podaj numer płatności lub ID zadania, ale nigdy klucz API.
Warunki zwrotu i pomoc w sprawie płatności za API uzyskasz w rozliczeniach lub u wsparcia. Zasady zwrotów i wygasania pakietów kredytów strony nie przechodzą automatycznie na środki API. Zwolnienie blokady zadania i zwrot płatności to różne zdarzenia.
Błędy, które możesz napotkać
| Kod | Znaczenie | Co zrobić |
|---|---|---|
40201 | Dostępne USD w API nie pokrywają blokady tego zadania | Doładuj API w rozliczeniach API albo zmniejsz rozdzielczość, długość lub liczbę wyników |
40202 | Zadanie przekroczyłoby jeden z limitów wydatków klucza | Zwiększ lub usuń limit w konsoli API albo poczekaj na jego odnowienie |
40901 | Cena zmieniła się od wyceny | Pobierz nową wycenę i pokaż nową cenę w USD |
Wszystkie kody wymienia strona Błędy.
Czy wywołania API kosztują więcej niż generowanie na stronie?
Nie. Ten sam model z tymi samymi ustawieniami ma tę samą cenę. Wywołania API są rozliczane w USD z salda API; generowanie na stronie i wywołania MCP przez OAuth zużywają kredyty strony. Salda pozostają oddzielne.
Czy muszę prosić o zwolnienie blokady zadania?
Nie. Nieudane i wygasłe zadania automatycznie zwalniają blokady, z uwzględnieniem ewentualnej opłaty danego modelu za odmowę z powodu treści. Ostateczną kwotę w USD sprawdź w rozliczonym costUsd zadania.
Czy mogę uzyskać zwrot płatności za doładowanie API?
Aby poznać warunki zwrotu lub uzyskać pomoc z płatnością za API, otwórz rozliczenia API albo skontaktuj się ze wsparciem.
Czy środki API podlegają zasadom wygasania kredytów strony?
Zasady wygasania pakietów kredytów i nagród strony nie określają warunków API. Sprawdź rozliczenia API albo zapytaj wsparcie o swoje środki API.
Czy mogę doładować API kredytami strony?
Nie. Doładuj API przez rozliczenia API. Kredyty strony nie zasilają API, środki API nie opłacają generowania na stronie, a sald nie można między sobą przenosić.

