PopNowDokumentacja API
Saldo API i rozliczenia
Treść główna

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/quote zwraca expectedChargeUsd i maxChargeUsd jako ciągi dziesiętne w USD, nie uruchamiając zadania.
  • Odczytaj rozliczoną kwotę. costUsd zadania to ostateczne obciążenie w USD, gdy settled ma 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 miejsceUżywane saldo
REST lub zgodne API z kluczem sk-popnow-USD w API
Playground na stronie modelu APIUSD w API
MCP uwierzytelnione kluczem APIUSD w API
Generowanie na stronie lub MCP połączone przez OAuthKredyty 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:

ModelCo otrzymujeszUSD
Z-Image TurboJeden obraz$0.01
Nano Banana 2.1Jeden obraz w 1K / 2K / 4K$0.048 / $0.072 / $0.162
Seedream 5.0 ProJeden obraz w 1K / 2K$0.036 / $0.072
MiniMax H3Zdjęcie na wideo, 768p, 5 sekund$0.185
Suno v6Jeden utwór$0.072
Background RemoverJeden przezroczysty PNG$0.0048
Image UpscalerJedno 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}}'
Python
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")
JavaScript
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:

WynikIle płacisz
succeededFaktyczne obciążenie w USD, nigdy więcej niż blokada; niewykorzystana kwota jest zwalniana
failed lub expiredNic; 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ć

KodZnaczenieCo zrobić
40201Dostępne USD w API nie pokrywają blokady tego zadaniaDoładuj API w rozliczeniach API albo zmniejsz rozdzielczość, długość lub liczbę wyników
40202Zadanie przekroczyłoby jeden z limitów wydatków kluczaZwiększ lub usuń limit w konsoli API albo poczekaj na jego odnowienie
40901Cena zmieniła się od wycenyPobierz 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ć.

Na tej stronie