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. Wywołania z kluczem API, MCP dla deweloperów i uruchomienia w Playground na stronach API zużywają to saldo. Ten sam model z tymi samymi ustawieniami kosztuje w API tyle samo co na popnow.ai.
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.
- Własne doładowania. Do tego salda trafiają tylko środki API dodane w rozliczeniach API i wydawane wyłącznie przez API.
- Wyceń przed uruchomieniem.
jobs/quotezwracaexpectedChargeUsdimaxChargeUsdjako ciągi dziesiętne w USD, nie uruchamiając zadania. - Sprawdź rozliczoną kwotę.
costUsdzadania to ostateczne obciążenie w USD, gdysettledma wartośćtrue. Nieudane lub wygasłe zadania automatycznie zwalniają blokady.
Skąd biorą się środki API
Doładowuj API i sprawdzaj historię płatności w rozliczeniach API, korzystając z dostępnych tam metod płatności. Klucze twórz i zarządzaj nimi osobno na stronie kluczy API.
Co obciąża saldo API
| Wywołanie lub miejsce | Opłacane z |
|---|---|
REST lub zgodne API z kluczem sk-popnow- | Saldo API |
| Playground na stronie modelu API | Saldo API |
| MCP dla deweloperów z kluczem API | Saldo API |
| Uruchomienia zapisanych przepisów przez API lub MCP dla deweloperów | Saldo API |
Jeśli żądanie API nie może pokryć swojej blokady, dodaj środki API w rozliczeniach API.
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. 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 |
| Odrzucone ze względu na treść | Nic |
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.
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.
Czy muszę prosić o zwolnienie blokady zadania?
Nie. Nieudane i wygasłe zadania automatycznie zwalniają blokady. 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.

