Jak działa API PopNow
Co można tworzyć przez API, pięć pojęć, na których opiera się cała dokumentacja, i kolejność czytania.
API PopNow pozwala twojemu oprogramowaniu korzystać z modeli obrazu, wideo i audio, które znasz z popnow.ai. Te same modele, te same ceny, te same kredyty — tylko wywoływane z kodu, a nie klikane w przeglądarce.
Co możesz tworzyć
| Wynik | Przykłady |
|---|---|
| Obrazy | Obraz z tekstu, edycja z jednym lub kilkoma obrazami referencyjnymi, powiększanie, usuwanie tła, rozdzielanie na warstwy |
| Wideo | Wideo z tekstu, wideo z obrazu, wideo z pierwszą i ostatnią klatką, wideo z referencji, przedłużanie i edycja klipów, synchronizacja ust, mówiące awatary |
| Audio | Muzyka, efekty dźwiękowe, zamiana tekstu na mowę, dźwięk do istniejącego wideo, zamiana mowy na tekst |
Pełna lista z ID i ceną każdego modelu jest na stronie Modele. API obejmuje tylko generowanie obrazów, wideo i audio; modele czatu i tekstu nie są jego częścią.
Pięć pojęć, które spotkasz wszędzie
ID modelu
Wszystko, co możesz wywołać, ma ID w postaci <maker>/<model>/<task>, np. alibaba/wan-3.0/image-to-video albo google/nano-banana-2.1/edit. Wpisujesz je w pole model każdego zapytania. Edycja obrazu zawsze kończy się na /edit. Narzędzia zbudowane przez samo PopNow, np. usuwanie tła, mają twórcę popnow.
Zadanie
Generowanie trwa od kilku sekund do kilku minut, więc każde zapytanie tworzy zadanie. taskId dostajesz od razu, a wynik odczytujesz, gdy będzie gotowy. Zadanie przechodzi z queued przez running do jednego stanu końcowego: succeeded, failed albo expired. Szczegóły: Zadania.
Kredyty
API zużywa te same kredyty co strona. Według stawki bazowej 1 kredyt = 0,01 USD. Gdy zadanie zostanie przyjęte, blokowana jest najwyższa cena, jaką może osiągnąć; gdy się skończy, płacisz faktyczną kwotę (nigdy więcej niż blokada), a reszta jest zwalniana. Nieudane zadanie nic nie kosztuje. Szczegóły: Kredyty i rozliczenia.
Klucz idempotencji
Przekroczenie czasu sieci nie mówi, czy serwer dostał zapytanie. Wysyłaj nagłówek Idempotency-Key z każdym tworzonym zadaniem, a ponowienie z tym samym kluczem zwróci pierwotne zadanie, zamiast utworzyć — i obciążyć — drugie. Szczegóły: Idempotencja.
Webhook
Zamiast w kółko pytać o zadanie, podaj mu callBackUrl. Gdy zadanie się skończy, PopNow wyśle pełny wynik na ten adres, z podpisem, dzięki któremu sprawdzisz, że pochodzi od nas. Szczegóły: Webhooki.
Jak wygląda zapytanie
POST https://api.popnow.ai/api/v1/jobs/createTask
Authorization: Bearer sk-popnow-...
Idempotency-Key: 7d0c9a52-...
{ "model": "alibaba/wan-3.0/image-to-video",
"input": { "image_url": "https://…/photo.jpg", "prompt": "The waves roll in slowly" },
"callBackUrl": "https://your-app.example.com/hooks/popnow" }Każda odpowiedź używa tej samej koperty, { "code", "msg", "data", "request_id" }, w której code: 200 oznacza sukces.
Kolejność czytania
- Szybki start — pierwszy wynik w pięć minut.
- Uwierzytelnianie — jak chronić klucz i ograniczać, co może robić.
- Modele — wybierz model i odczytaj jego parametry.
- Zadania i Webhooki — pełny cykl życia.
- Media — wysyłanie własnych obrazów, wideo i audio.
- Błędy i Limity zapytań — przed wdrożeniem.
Chcesz wypróbować model, zanim napiszesz kod? Każdy model ma Playground na swojej stronie API na popnow.ai, który działa na twoim koncie bez klucza.