Modelle

Jedes aufrufbare Modell hat eine Modell-ID, die ins Feld model von createTask gehört. Die Tabelle unten auf dieser Seite listet alle mit ihrem Einstiegspreis; jeder Name führt zu einer Referenzseite mit allen Parametern, Preisstufen und einer Anfrage zum Kopieren.

So ist eine Modell-ID aufgebaut

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

• maker ist, wer das Modell gebaut hat. Werkzeuge von PopNow selbst heißen popnow.
• model behält die Punkte der Version: seedance-2.0, nicht seedance-2-0.
• task sagt, was der Aufruf tut: text-to-image, edit, image-to-video, reference-to-video, video-extend, text-to-speech, text-to-audio und so weiter. Bildbearbeitung heißt immer edit.

Eine Modellfamilie hat meist mehrere IDs, eine pro Aufgabe. Nimm die, die zu dem passt, was du schickst: .../text-to-video braucht nur einen Prompt, .../image-to-video ein Startbild.

Den Katalog per Code lesen

Maßgeblich ist der Live-Katalog: Er zeigt, was gerade verfügbar ist, und die Preise, die für dein Konto gelten.

# 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"

Filter für die Liste: modality (image, video, audio), provider, task, search, dazu includeSchema=1 und includeExamples=1 für Eingabeschemas und geprüfte Beispieleingaben. Wenn dein HTTP-Client einen Pfadparameter als ein Segment behandelt, kodiere die Schrägstriche als %2F.

Lesenswerte Felder

Preise lesen

credits ist derselbe Preis, den popnow.ai anzeigt, in Credits (1 Credit = 0,01 $):

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

unit sagt, wie der Preis skaliert (per_image, per_second, per_request, per_1k_characters), perUnit ist der Einstiegspreis, und jede Regel gilt, wenn die Anfrage zu ihren when-Werten passt (* steht für die Einstellung, die die Stufe bestimmt, hier resolution). Die endgültige Abbuchung eines Tasks wird auf ganze Credits aufgerundet.

Den genauen Betrag für eine bestimmte Anfrage nennt dir jobs/quote mit demselben Body, den du an createTask schicken würdest.

Eingabeschemas

inputSchema ist Standard-JSON-Schema (Draft 2020-12). Ein paar Regeln gelten für jedes Modell:

• Unbekannte Felder werden abgelehnt. Ein vertipptes aspect_ration liefert 400, statt still ignoriert zu werden.
• Feldnamen sind über Modelle hinweg gleich. Dieselbe Sache heißt immer gleich: prompt, negative_prompt, image_url, image_urls, video_url, audio_url, duration_seconds, aspect_ratio, resolution, seed, generate_audio.
• Standardwerte werden für dich ergänzt. Schick nur, was du ändern willst.
• Medienfelder nehmen eine öffentliche HTTPS-URL, eine hochgeladene popnow://-Datei oder ein gespeichertes Asset. Siehe Medien.
• Anzeigehinweise stecken in einem x-ui-Objekt pro Eigenschaft (Beschriftungen, Reihenfolge, Schieberegler-Schritte). Sie ändern nie die Prüfung; ignoriere Schlüssel, die du nicht kennst.

Lässt du bei einem Modell mit seed den Wert weg, wird ein zufälliger gewählt und im input des Tasks zurückgegeben – so kannst du ein gelungenes Ergebnis wiederholen.

Caching

Katalogantworten sind privat für dein Konto und 60 Sekunden cachebar. Bewährt hat sich: die Liste ein paar Minuten cachen, ein einzelnes Modell neu lesen, wenn sich seine version ändert, und available: false als „später noch mal oder ein anderes Modell“ behandeln.

Alle aufrufbaren Modelle

Die Preise sind die niedrigste Stufe pro Einheit; höhere Auflösungen, längere Clips und Zusatzoptionen kosten mehr. Die Seite jedes Modells zeigt alle Stufen.