PopNowDokumentacja API
Dokumentacja i pomoc
Treść główna

Historia zmian

Datowane zmiany istotne dla programistów w API PopNow do generowania obrazów, wideo i audio AI, zdalnym serwerze MCP, webhookach, rozliczeniach i tej dokumentacji.

Zmiany wpływające na kod korzystający z PopNow, od najnowszych. Wymieniamy też nowości, które nie wymagają żadnego działania, by pokazać nowe możliwości. Daty podano w UTC.

Żadna z poniższych zmian nie psuje istniejącej integracji, chyba że oznaczono ją jako Wymagane działanie.

2026-10-23

Wymagane działanie: osobne saldo API w USD. Wywołania z kluczem API, MCP z kluczem API i uruchomienia w Playground zużywają osobne saldo API w USD, początkowo wynoszące 0 USD. Kredytów strony i środków API nie można między sobą przenosić ani używać zamiennie. MCP przez OAuth nadal zużywa kredyty strony. Ceny modeli pozostają takie same. Klucze twórz na stronie kluczy API; doładowania API i płatności sprawdzaj w rozliczeniach API. Do wyświetlania i księgowości używaj istniejących pól w USD (costUsd, estimatedCostUsd, maxChargeUsd, availableUsd, heldUsd, totalUsd, totalSpend). Potwierdzaj wyceny przez istniejące pola w USD: wyślij quoteId i expectedCostUsd: quote.maxChargeUsd z tym samym zapytaniem przed wygaśnięciem wyceny. Zobacz Rozliczenia API oraz Saldo API i zwroty. Starsze wpisy poniżej opisują działanie z podanych dat, w tym poprzednie wspólne saldo kredytów i zaokrąglanie do pełnych kredytów.

Wymagane działanie: zatwierdzanie zapisanych przepisów w USD. Uruchomienia przepisów i workflowów przez REST i MCP z kluczem API korzystają teraz z wycen w USD: pobierz wycenę, a potem potwierdź te same dane wejściowe przez currency: "USD", max_usd zapisane jako ciąg dziesiętny i quote_id. Stare limity kredytów są odrzucane. Odczytuj i wznawiaj uruchomienie jego pierwotnym kluczem. Nowy endpoint wznowienia i narzędzie resume_recipe_run służą do wyceny i zatwierdzenia budżetu całego uruchomienia, w tym już wydanych środków i zobowiązań związanych z trwającą pracą. Wycena z unpriced_steps obejmuje tylko kroki, które można obecnie wycenić; późniejsze kroki czekają na nową wycenę i zgodę. Uruchomienia przepisów przez OAuth MCP nadal korzystają z kredytów strony. Zobacz Zapisane przepisy.

Modele czatowe w dokumentacji. Claude, Gemini, DeepSeek, GLM, Grok i Kimi można wywoływać tym samym kluczem API przez OpenAI Chat Completions i Responses (https://api.popnow.ai/v1), Anthropic Messages i Gemini generateContent, z rozliczeniem za token w USD. Strona Modele czatowe zawiera adresy bazowe, przykłady SDK, strumieniowanie, ceny za token i opis rozliczania zapytań. Dokumentacja API wymienia trasy oraz brakujące wcześniej endpointy przepisów, umiejętności i umiejętności agentów.

Łatwiejsza nawigacja w dokumentacji. Strona główna dokumentacji ma teraz ten sam panel boczny co pozostałe strony. Panel uporządkowano według wykonywanych zadań, a każda strona jest dostępna we wszystkich 12 językach.

2026-10-22

SDK i integracje w rejestrach pakietów. Oficjalnych pakietów open source nie trzeba już instalować z GitHuba:

  • Python: pip install popnow (PyPI). JavaScript i TypeScript: npm install popnow (npm, także JSR). CLI: npm install -g @popnow/cli.
  • PHP: composer require popnow/popnow (Packagist). Go: go get github.com/popnow-ai/popnow-go. Nowość: klient Java, ai.popnow:popnow-java w Maven Central.
  • ComfyUI: pakiet węzłów to popnow-comfyui w Comfy Registry. Zainstaluj go przez ComfyUI Manager lub poleceniem comfy node install popnow-comfyui. Węzeł w pojedynczym pliku nadal działa; wybierz jedno z tych rozwiązań.
  • n8n: węzeł społecznościowy n8n-nodes-popnow jest dostępny w npm. We własnej instalacji n8n zainstaluj go przez Settings > Community Nodes. Nie jest jeszcze zweryfikowany, więc n8n Cloud nadal korzysta z workflow HTTP Request.
  • Również nowe: popnow-proxy (npm install @popnow/proxy) przechowuje klucz API na twoim serwerze, gdy przeglądarka lub aplikacja mobilna wywołuje API, a popnow-bot to samodzielnie hostowany bot Telegram i Discord. Most MCP stdio uruchomisz przez npx -y @popnow/mcp.

Jeśli wcześniej instalowałeś z GitHuba, możesz przejść na pakiet z rejestru; importy pozostają takie same. Wszystkie polecenia znajdziesz na stronie SDK, CLI i narzędzia open source.

2026-10-21

Uruchamiaj zapisane przepisy, workflow i umiejętności. Przepisy zapisane w Studio, workflow zapisane z płótna i umiejętności Poppie można teraz wyświetlać i uruchamiać przez API: GET /api/v1/recipes, POST /api/v1/recipes/{id}/run (z maxCredits ograniczającym cenę), GET /api/v1/recipes/runs/{runId} oraz GET /api/v1/skills. MCP zyskuje pięć odpowiadających im narzędzi: list_my_recipes, run_my_recipe, get_recipe_run, list_my_skills i use_my_skill. Wszystko pozostaje prywatne dla ciebie i twoich zespołów. Zobacz Twoje przepisy, workflow i umiejętności. Konsola programistyczna ma nową stronę Recipes & skills z ID każdego elementu i gotowym kodem do uruchomienia.

2026-10-19

Wymagane działanie: 1 kredyt to teraz 0,001 USD, a ceny są niższe. Wcześniej kredyt był wart 0,01 USD; teraz jest wart 0,001 USD. Każde saldo, cena i kwota w kredytach są liczbowo 10 razy większe przy tej samej wartości w dolarach. Jednocześnie ceny wszystkich modeli spadły o około jedną trzecią, więc to samo zapytanie kosztuje teraz mniej dolarów niż wcześniej.

  • Saldo zostało przeliczone. Nic nie zniknęło: saldo 500 kredytów (5 USD) wynosi teraz 5000 kredytów (5 USD). Limity wydatków kluczy zachowują tę samą wartość w dolarach i pokazują nowe kwoty kredytów.
  • Pola API. credits, maxCredits, expectedCredits, estimatedCredits, availableCredits, heldCredits, totalCredits i ceny credits w GET /api/v1/models są podawane w nowej jednostce. Ciągi w dolarach (cost, maxCharge, estimatedCost, available …) zachowują dotychczasowe znaczenie. Jeśli twój kod przelicza kredyty na dolary przez dzielenie przez 100, dziel teraz przez 1000; zapisane progi lub budżety w kredytach pomnóż przez 10.
  • Stare wyceny. quoteId i expectedCredits sprzed zmiany nie pasują już do cen. createTask odpowiada 40901 (zmiana ceny) i niczego nie blokuje; pobierz nową wycenę i pokaż nową cenę.
  • Zaokrąglanie. Zadanie nadal rozliczane jest w pełnych kredytach, z zaokrągleniem w górę, ale pełny kredyt to teraz jedna dziesiąta centa, więc krok zaokrąglenia jest dziesięć razy mniejszy.
  • MCP. Zadania do 300 kredytów ruszają od razu; większe nadal czekają na zgodę użytkownika. Zobacz PopNow w ChatGPT i Claude.
  • Pakiety kredytów. Pakiety zaczynają się od 9 USD za 9000 kredytów, z bonusami w większych pakietach. Możesz też kupić własną kwotę od 10 do 2000 USD, po 1000 kredytów za 1 USD. Zobacz cennik oraz Kredyty i zwroty.

SDK i narzędzia open source. Kod PopNow dla programistów jest teraz publiczny pod github.com/popnow-ai, na licencji MIT: SDK dla Pythona i JavaScriptu oraz TypeScriptu, CLI, klienci Go i PHP, instrukcja konfiguracji MCP, Agent Skills, plik OpenAPI z przykładami oraz kod dodatku do Blendera, pakietu węzłów ComfyUI i węzła społecznościowego n8n.

  • Żaden z nich nie jest jeszcze dostępny w npm, PyPI, Packagist ani ComfyUI Registry. Instaluj z GitHuba zgodnie z nową stroną SDK, CLI i narzędzia open source.
  • Szybki start pokazuje SDK dla Pythona i JavaScriptu obok niezmienionych przykładów zwykłego HTTP.

2026-10-17

Zdalny serwer MCP. PopNow udostępnia teraz serwer MCP pod https://api.popnow.ai/mcp. Możesz dodać go do ChatGPT lub Claude i tworzyć obrazy, wideo, utwory i nagrania lektorskie na czacie; programiści mogą dodać go do Cursor, VS Code, Claude Code lub własnego klienta MCP. Dwanaście narzędzi, logowanie OAuth 2.1 lub klucz API sk-popnow-, te same kredyty i ceny co wszędzie indziej. Zadania do 30 kredytów (300 od 2026-10-19) ruszają od razu; większe czekają na potwierdzenie użytkownika. Zobacz PopNow w ChatGPT i Claude.

  • Połączenia można przeglądać i usuwać w Account settings → Devices → Connected AI apps.
  • Wywołania kluczem API wliczają się do limitów wydatków tego klucza i pojawiają się w logach konsoli.
  • Efekty wideo (Zombie Turn, Flying Car i pozostałe ze strony Effects) są dostępne w aplikacjach czatowych przez apply_effect. Nie są endpointami REST.

Nowe strony dokumentacji. Kredyty i zwroty, instrukcje integracji z n8n, ComfyUI i dodatkiem do Blendera, Przepisy oraz ta historia zmian. Strona Webhooki zyskała sekcję zarządzania endpointami konta w konsoli.

Zasady zwrotów pakietów kredytów. Pakiet kredytów można zwrócić w ciągu 7 dni od zakupu (14 dni dla konsumentów w UE i Wielkiej Brytanii), jeśli nie wykorzystano żadnego z jego kredytów; nieudane generowania nadal automatycznie zwalniają kredyty. Bezpłatne kredyty z nagród zużywane są przed kredytami z pakietów, a pakiety od najstarszego do najnowszego. Szczegóły: Kredyty i zwroty.

Strony integracji na popnow.ai. Strony n8n, ComfyUI i Przepisy pokazują teraz rzeczywiste wyniki obok generowanego kodu.

2026-10-16

Otwarcie API PopNow. Jedno REST API do generowania obrazów, wideo i audio pod https://api.popnow.ai/api/v1, opisane tutaj na popnow.ai/docs w 12 językach, z plikiem OpenAPI i llms.txt dla narzędzi i agentów.

  • Klucze zaczynają się od sk-popnow-. Klucze utworzone przed zmianą prefiksu nadal działają; nie trzeba ich wymieniać.
  • Kwoty podawane są w kredytach (1 kredyt = 0,01 USD przy uruchomieniu, 0,001 USD od 2026-10-19): credits, maxCredits, expectedCredits, availableCredits i pozostałe pola kredytów występują obok ciągów w dolarach. Korzystaj z pól kredytów.
  • ID modeli mają postać <maker>/<model>/<task>, na przykład google/nano-banana-2.1/text-to-image. Własne narzędzia PopNow mają popnow w miejscu twórcy.
  • Referencje popnow:// dla przesłanych plików (popnow://f/…) i elementów biblioteki zasobów (popnow://a/…), dostępne w każdym polu multimedialnym. Zobacz Media.
  • Modele czatowe i tekstowe nie wchodzą w skład publicznego API. API obejmuje generowanie obrazów, wideo i audio.

Wersja 2 treści webhooków. Nowe powiadomienia o zadaniach są wysyłane z X-Webhook-Payload-Version: 2, a ich treść odpowiada recordInfo. Zobacz Webhooki.

Konsola programistyczna. Endpointy webhooków na poziomie konta (podpisy Standard Webhooks, do 16 na konto, osobny sekret dla każdego endpointu), dziennik dostarczeń z ręcznym ponowieniem, uruchomienia Playground na stronie API każdego modelu, filtry kluczy w logach i eksport zużycia do CSV.

Sprawdzanie treści przy wysyłaniu. Prompty i obrazy wejściowe są sprawdzane przed przyjęciem zadania. Odrzucone zapytanie zwraca 400 z data.reason, niczego nie blokuje i nic nie kosztuje. Zapytania odrzucone przez sam model nadal kończą się bezpłatnie jako content_rejected.

Komunikaty błędów po chińsku. msg i errorMessage respektują teraz Accept-Language także dla zh-CN i zh-TW, obok dziesięciu już obsługiwanych języków. Kody pozostają bez zmian. Zobacz Błędy.

Trasy wideo zgodne z OpenAI pod /v1 przyjmują też klucz w nagłówku x-api-key. Zobacz OpenAI Videos.

Dodatek do Blendera 0.1.0. Renderowanie, animacja i tekstury na podstawie glinianej sceny w Blenderze 4.2 lub nowszym z własnym kluczem API. Zobacz Dodatek do Blendera.

2026-10-15

Biblioteka zasobów: postacie. Postacie (nazwane zestawy obrazów referencyjnych ułożone na stronie) są przechowywane w bibliotece zasobów i można je odczytać przez GET /api/v1/assets/entities; każdy obraz ma własne URI popnow://a/… do zapytań generowania. Postacie tworzy się i edytuje na stronie; API je odczytuje. Zobacz Zasoby.

Na tej stronie