Modele

Każdy model, który możesz wywołać, ma ID modelu — wpisuje się je w pole model w createTask. Tabela na dole tej strony zawiera wszystkie modele z ceną początkową; każda nazwa prowadzi do strony referencyjnej z pełną listą parametrów, progami cen i zapytaniem do skopiowania.

Jak zbudowane jest ID modelu

<maker>/<model>/<task>
alibaba/wan-3.0/image-to-video
google/nano-banana-2.1/edit
popnow/background-remover-v1/edit

• maker to twórca modelu. Narzędzia zbudowane przez samo PopNow mają popnow.
• model zachowuje kropki wersji: seedance-2.0, a nie seedance-2-0.
• task mówi, co robi wywołanie: text-to-image, edit, image-to-video, reference-to-video, video-extend, text-to-speech, text-to-audio i tak dalej. Edycja obrazu to zawsze edit.

Rodzina modeli ma zwykle kilka ID, po jednym na zadanie. Wybierz to, które pasuje do tego, co wysyłasz: .../text-to-video wymaga tylko promptu, .../image-to-video — obrazu startowego.

Odczyt katalogu z kodu

Źródłem prawdy jest katalog na żywo: pokazuje, co jest dostępne w tej chwili, i ceny obowiązujące na twoim koncie.

# Every video model, with input schemas
curl "https://api.popnow.ai/api/v1/models?modality=video&includeSchema=1" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

# One model. The ID contains slashes; send it as it is.
curl "https://api.popnow.ai/api/v1/models/alibaba/wan-3.0/image-to-video" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Filtry listy: modality (image, video, audio), provider, task, search, a do tego includeSchema=1 i includeExamples=1, by dołączyć schematy wejściowe i sprawdzone przykładowe dane. Jeśli twój klient HTTP traktuje parametr ścieżki jako jeden segment, zakoduj ukośniki jako %2F.

Pola warte odczytania

Odczyt cen

credits to ta sama cena, którą pokazuje popnow.ai, w kredytach (1 kredyt = 0,01 USD):

"credits": {
  "unit": "per_second",
  "perUnit": 6.75,
  "rules": [
    { "when": { "*": "480p" }, "perUnit": 6.75 },
    { "when": { "*": "720p" }, "perUnit": 13.5 },
    { "when": { "*": "1080p" }, "perUnit": 27 }
  ]
}

unit mówi, jak rośnie cena (per_image, per_second, per_request, per_1k_characters), perUnit to cena początkowa, a każda reguła obowiązuje, gdy zapytanie pasuje do jej wartości when (* oznacza ustawienie wyznaczające próg, tu resolution). Ostateczne obciążenie za zadanie jest zaokrąglane w górę do pełnych kredytów.

Dokładną kwotę dla konkretnego zapytania poda jobs/quote z tą samą treścią, którą wysłałbyś do createTask.

Schematy wejściowe

inputSchema to standardowy JSON Schema (draft 2020-12). Kilka zasad dotyczy każdego modelu:

• Nieznane pola są odrzucane. Literówka w rodzaju aspect_ration daje 400 zamiast cichego pominięcia.
• Nazwy pól są wspólne dla modeli. Ta sama rzecz zawsze ma tę samą nazwę: prompt, negative_prompt, image_url, image_urls, video_url, audio_url, duration_seconds, aspect_ratio, resolution, seed, generate_audio.
• Wartości domyślne są uzupełniane za ciebie. Wysyłaj tylko to, co chcesz zmienić.
• Pola mediów przyjmują publiczny URL HTTPS, przesłany przez ciebie plik popnow:// albo zapisany zasób. Zobacz Media.
• Wskazówki do wyświetlania są w obiekcie x-ui przy każdej właściwości (etykiety, kolejność, krok suwaków). Nigdy nie zmieniają walidacji; ignoruj klucze, których nie znasz.

Jeśli pominiesz seed w modelu, który go ma, zostanie wylosowana wartość i zwrócona w input zadania — dzięki temu powtórzysz wynik, który ci się spodobał.

Cache

Odpowiedzi katalogu są prywatne dla twojego konta i można je cache’ować przez 60 sekund. Sensowny wzorzec: trzymać listę w cache przez kilka minut, odczytać model ponownie, gdy zmieni się jego version, a available: false traktować jako „spróbuj później albo wybierz inny model”.

Wszystkie dostępne modele

Ceny to najniższy próg za jednostkę; wyższe rozdzielczości, dłuższe klipy i dodatkowe opcje kosztują więcej. Strona każdego modelu pokazuje wszystkie progi.