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. 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/quote zwraca expectedChargeUsd i maxChargeUsd jako ciągi dziesiętne w USD, nie uruchamiając zadania.
  • Sprawdź rozliczoną kwotę. costUsd zadania to ostateczne obciążenie w USD, gdy settled ma 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 miejsceOpłacane z
REST lub zgodne API z kluczem sk-popnow-Saldo API
Playground na stronie modelu APISaldo API
MCP dla deweloperów z kluczem APISaldo API
Uruchomienia zapisanych przepisów przez API lub MCP dla deweloperówSaldo 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:

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. 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
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ć

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.

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.

Na tej stronie