API-Referenz

Alle Endpunkte der PopNow API auf einer Seite, mit Links zum vollständigen OpenAPI-Vertrag.

Der vollständige, maschinenlesbare Vertrag ist openapi.yaml (OpenAPI 3.1). Importier ihn in Postman, Insomnia oder einen Codegenerator oder gib ihn einem KI-Agenten. Diese Seite ist die Karte für Menschen.

Basis-URL: https://api.popnow.ai/api/v1 (OpenAI-kompatible Routen: https://api.popnow.ai/v1)
Authentifizierung: Authorization: Bearer sk-popnow-… bei jeder Anfrage
Hülle: { "code", "msg", "data", "request_id" }; code: 200 heißt Erfolg
Beträge: ganze Credits (credits, maxCredits …), jeweils auch als US-Dollar-String; 1 Credit = 0,01 $

Tasks

Methode und Pfad	Funktion	Seite
`POST /jobs/createTask`	Einen Generierungs-Task erstellen (optional `?wait=` bis 60 s)	Tasks
`GET /jobs/recordInfo?taskId=`	Zustand und Ergebnis eines Tasks lesen	Tasks
`GET /jobs`	Die Tasks dieses Schlüssels auflisten	Tasks
`POST /jobs/quote`	Eine Anfrage bepreisen, ohne sie auszuführen	Abrechnung
`POST /jobs/retry`	Neuer Task aus einem gescheiterten oder abgelaufenen	Tasks
`POST /jobs/purge`	Den Inhalt eines fertigen Tasks löschen	Tasks

Modelle

Methode und Pfad	Funktion	Seite
`GET /models`	Alle aufrufbaren Modelle mit Preisen (`?includeSchema=1` für Eingabeschemas)	Modelle
`GET /models/{model}`	Ein Modell inklusive Eingabeschema	Modelle

Dateien und Assets

Methode und Pfad	Funktion	Seite
`POST /common/upload-url`	Ticket für einen Direkt-Upload	Medien
`POST /files/{fileId}/commit`	Upload abschließen und `popnow://`-URI erhalten	Medien
`POST /files/import`	Eine LoRA-Datei per Link importieren	Assets
`POST /common/download-url`	Frischer signierter Link zur Ausgabe eines Tasks	Medien
`GET /assets`, `POST /assets`	Assets auflisten oder speichern	Assets
`GET`, `PATCH`, `DELETE /assets/{assetId}`	Ein Asset lesen, umbenennen oder löschen	Assets
`GET /assets/entities`	Deine Charaktere	Assets
`GET /assets/usage`	Speicherplan und Nutzung	Assets

Konto

Methode und Pfad	Funktion	Seite
`GET /chat/credit`	Guthaben: verfügbar, reserviert, gesamt	Abrechnung
`GET /usage`	Nutzung dieses Schlüssels nach Tag und Modell	Abrechnung

OpenAI-Videos-kompatibel (`/v1`)

Methode und Pfad	Funktion	Seite
`POST /v1/videos`	Einen Video-Task erstellen	OpenAI Videos
`GET /v1/videos/{id}`	Ihn lesen	OpenAI Videos
`GET /v1/videos/{id}/content`	Weiterleitung zur Datei	OpenAI Videos
`GET /v1/models`	Modellliste im OpenAI-Format	OpenAI Videos

Gemeinsame Header

Header	Richtung	Bedeutung
`Idempotency-Key`	Anfrage	Macht Wiederholungen eines Schreibzugriffs 24 Stunden lang sicher (Idempotenz)
`Accept-Language`	Anfrage	Sprache der Fehlermeldungen (Fehler)
`X-PopNow-Retention`	Anfrage	Aufbewahrung des Inhalts eines Tasks verkürzen, in Sekunden
`X-Request-Id`	Antwort	Wie `request_id`; beim Support angeben
`X-RateLimit-Limit`, `X-RateLimit-Remaining`, `Retry-After`	Antwort	Ratenlimits (Ratenlimits)