Dokumentacja API

Wszystkie endpointy API PopNow na jednej stronie, z linkami do pełnego kontraktu OpenAPI.

Pełny, czytelny dla maszyn kontrakt to openapi.yaml (OpenAPI 3.1). Zaimportuj go do Postmana, Insomnii albo generatora kodu lub przekaż agentowi AI. Ta strona to mapa dla ludzi.

Bazowy URL: https://api.popnow.ai/api/v1 (trasy zgodne z OpenAI: https://api.popnow.ai/v1)
Uwierzytelnianie: Authorization: Bearer sk-popnow-… w każdym zapytaniu
Koperta: { "code", "msg", "data", "request_id" }; code: 200 oznacza sukces
Kwoty: pełne kredyty (credits, maxCredits …), każda także jako ciąg w dolarach; 1 kredyt = 0,01 USD

Zadania

Metoda i ścieżka	Co robi	Strona
`POST /jobs/createTask`	Utwórz zadanie generowania (opcjonalnie `?wait=`, do 60 s)	Zadania
`GET /jobs/recordInfo?taskId=`	Odczytaj stan i wynik zadania	Zadania
`GET /jobs`	Lista zadań tego klucza	Zadania
`POST /jobs/quote`	Wyceń zapytanie bez uruchamiania	Rozliczenia
`POST /jobs/retry`	Nowe zadanie z nieudanego lub wygasłego	Zadania
`POST /jobs/purge`	Usuń treść zakończonego zadania	Zadania

Modele

Metoda i ścieżka	Co robi	Strona
`GET /models`	Wszystkie dostępne modele z cenami (`?includeSchema=1` ze schematami wejściowymi)	Modele
`GET /models/{model}`	Jeden model ze schematem wejściowym	Modele

Pliki i zasoby

Metoda i ścieżka	Co robi	Strona
`POST /common/upload-url`	Bilet do bezpośredniego przesłania	Media
`POST /files/{fileId}/commit`	Zakończ przesyłanie i dostań URI `popnow://`	Media
`POST /files/import`	Zaimportuj plik LoRA z linku	Zasoby
`POST /common/download-url`	Nowy podpisany link do wyniku zadania	Media
`GET /assets`, `POST /assets`	Wylistuj lub zapisz zasoby	Zasoby
`GET`, `PATCH`, `DELETE /assets/{assetId}`	Odczytaj, zmień nazwę lub usuń zasób	Zasoby
`GET /assets/entities`	Twoje postacie	Zasoby
`GET /assets/usage`	Plan przechowywania i zużycie	Zasoby

Konto

Metoda i ścieżka	Co robi	Strona
`GET /chat/credit`	Saldo: dostępne, zablokowane, łącznie	Rozliczenia
`GET /usage`	Zużycie tego klucza według dni i modeli	Rozliczenia

Zgodność z OpenAI Videos (`/v1`)

Metoda i ścieżka	Co robi	Strona
`POST /v1/videos`	Utwórz zadanie wideo	OpenAI Videos
`GET /v1/videos/{id}`	Odczytaj je	OpenAI Videos
`GET /v1/videos/{id}/content`	Przekieruj do pliku	OpenAI Videos
`GET /v1/models`	Lista modeli w formacie OpenAI	OpenAI Videos

Wspólne nagłówki

Nagłówek	Kierunek	Znaczenie
`Idempotency-Key`	Zapytanie	Sprawia, że ponowienia zapisu są bezpieczne przez 24 godziny (Idempotencja)
`Accept-Language`	Zapytanie	Język komunikatów o błędach (Błędy)
`X-PopNow-Retention`	Zapytanie	Skróć przechowywanie treści zadania, w sekundach
`X-Request-Id`	Odpowiedź	To samo co `request_id`; podaj pomocy
`X-RateLimit-Limit`, `X-RateLimit-Remaining`, `Retry-After`	Odpowiedź	Limity zapytań (Limity zapytań)