PopNowAPI-Doku
Hauptinhalt

FLUX.2 Klein 4B API-Referenz

Das kleinste, schnellste FLUX für fixe Entwürfe

Mit einem einzigen PopNow-API-Schlüssel rufst du FLUX.2 Klein 4B aus deinem eigenen Code auf. Hier findest du die Modell-IDs, jedes Eingabefeld, die Kosten pro Anfrage in Credits und eine Anfrage, die du direkt ins Terminal kopieren kannst.

Die Parameterbeschreibungen stammen aus dem Eingabeschema des Modells und sind nur auf Englisch verfügbar.

Auf einen Blick

Hersteller
Black Forest Labs
Ergebnis
Bild
Ab
1.39 Credits pro Bild ($0.0139)
Typische Dauer
etwa 31 s

1 Credit = 0,01 $. Bei Annahme reserviert ein Task den höchstmöglichen Betrag und rechnet am Ende den tatsächlichen Verbrauch ab, auf ganze Credits aufgerundet; der Rest wird freigegeben. Fehlgeschlagene Tasks kosten nichts. Den genauen Betrag vorab liefert POST /api/v1/jobs/quote.

Bild erstellen

black-forest-labs/flux-2-klein-4b/text-to-image

Preis

OptionCredits (pro Bild)US-Dollar
1k1.39$0.0139
2k1.49$0.0149

Parameter

FeldTypStandardwertErlaubtBedeutung
promptPflichtstring—bis zu 5.000 ZeichenDescribe the subject, setting, light and style in plain sentences.
aspect_ratioOptionalstring1:11:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21Output aspect ratio.
resolutionOptionalstring1k1k, 2kOutput size tier: 1k is about one megapixel, 2k is 2048 pixels on the long side.
seedOptionalinteger—0 bis 2147483647Random seed for controlled comparisons.

Beispielanfrage

Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.

POST /api/v1/jobs/createTask
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "black-forest-labs/flux-2-klein-4b/text-to-image",
  "input": {
    "prompt": "A cozy reading nook beside a rain-streaked window, warm lamp light, a sleeping orange cat on a knitted blanket, soft film grain",
    "resolution": "1k"
  }
}'

Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Bild bearbeiten

black-forest-labs/flux-2-klein-4b/edit

Preis

OptionCredits (pro Bild)US-Dollar
Standard1.89$0.0189

Parameter

FeldTypStandardwertErlaubtBedeutung
promptPflichtstring—bis zu 5.000 ZeichenSay what to change and what must stay the same.
image_urlsPflichtarray<string (uri)>—bis zu 3 EinträgeOne to three source images, in the order your prompt refers to them.
aspect_ratioOptionalstringautoauto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21Output aspect ratio; auto keeps the shape of the first source image.
resolutionOptionalstring1k1k, 2kOutput size tier when you choose an aspect ratio; with auto the result keeps the shape of the first source image.
seedOptionalinteger—0 bis 2147483647Random seed for controlled comparisons.

Beispielanfrage

Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.

Das Beispiel nutzt in image_urls Beispieldateien von PopNow. Ersetze sie durch eigene öffentliche HTTPS-Links, Uploads oder gespeicherte Assets.

POST /api/v1/jobs/createTask?wait=60
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "black-forest-labs/flux-2-klein-4b/edit",
  "input": {
    "prompt": "Change the orange jacket to deep forest green and add soft golden-hour light; keep the face, pose and background unchanged",
    "image_urls": [
      "https://media.popnow.ai/influencer/examples/marco.webp"
    ]
  }
}'

Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Weiter geht’s

Auf dieser Seite