FLUX 3 Image Klein API-Leitfaden: Preise für fünf Auflösungsstufen, Parameter und Aufrufbeispiele

Was ist FLUX 3 Image Klein

FLUX 3 Image Klein ist das leichte Bildmodell innerhalb der FLUX 3-Serie von Black Forest Labs. Auf HiAPI gibt es nur eine Modell-ID: flux-3-image-klein, die sowohl für Text-zu-Bild als auch für die Bearbeitung mit Referenzbildern verwendet wird. Gibst du nur einen Prompt an, handelt es sich um Text-zu-Bild; fügst du image_urls hinzu, wird das Bild anhand von Referenzbildern verändert oder der Stil mehrerer Bilder miteinander verschmolzen.

Seine Stärken sind der niedrige Preis und die vielen Stufen: Von 768 bis 4K gibt es insgesamt fünf Auflösungsstufen, ideal für die Massenerzeugung von Bildern sowie für den Ablauf, zunächst mit kleinen Bildern zu experimentieren und anschließend das finale Bild in großer Auflösung zu erzeugen.

Preis: nach Auflösungsstufe, Abrechnung pro Bild

• 768: $0,0092 / Bild
• 1K (Standard): $0,0103 / Bild
• 1.5K: $0,0126 / Bild
• 2K: $0,016 / Bild
• 4K: $0,0412 / Bild

Referenzbilder werden nicht zusätzlich berechnet: Ob du 1 oder 10 Bilder mitgibst, kostet gleich viel. Auch ein niedrigerer Wert für steps macht es nicht günstiger; der Preis richtet sich ausschließlich nach resolution. Bei fehlgeschlagenen Aufgaben wird der volle Betrag erstattet.

Ein Beispiel: 50 Stilentwürfe in der 768-Stufe kosten $0,46; wählst du 5 davon aus und erzeugst die finalen Bilder in 4K, kostet das $0,206.

Parameter

Außer model und prompt sind alle Parameter optional:

• prompt: erforderlich, 1–5000 Zeichen.
• resolution: 768, 1K, 1.5K, 2K, 4K, Standard 1K.
• aspect_ratio: 16 mögliche Werte, darunter 21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4, 1:1, 4:5, 3:4, 5:7, 2:3, 9:16, 1:2, 9:21 und auto (Standard).
• image_urls: 1–10 öffentlich erreichbare Referenzbilder; ohne Angabe reine Text-zu-Bild-Generierung.
• steps: 1–16, Standard 16. Weniger Schritte erzeugen das Bild schneller, können aber Details reduzieren.
• seed: 0–4294967295. Mit festem Seed versuchen gleiche Parameter, ein ähnliches Ergebnis zu reproduzieren; ohne Angabe zufällig.
• safety_tolerance: 0–4, Standard 2. Je höher die Zahl, desto lockerer die Moderation.
• output_format: jpeg (Standard) oder png.

Anfragebeispiele

Bildaufgaben sind asynchron: Zuerst wird eine Aufgabe erstellt, dann wird das Ergebnis abgefragt. model steht auf der obersten Ebene, die übrigen Parameter kommen in input.

Text-zu-Bild, 2K, 4:5-Hochformat, fester Seed:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-3-image-klein",
    "input": {
      "prompt": "Eine Keramik-Kaffeetasse auf einem vom Morgenlicht beschienenen Holztisch, geringe Schärfentiefe, warme Farbtöne, Produktfotografie",
      "resolution": "2K",
      "aspect_ratio": "4:5",
      "seed": 42
    }
  }'

Dieses Bild kostet $0,016.

Bearbeitung mit Referenzbildern, Stilverschmelzung zweier Bilder:

{
  "model": "flux-3-image-klein",
  "input": {
    "prompt": "Behalte die Architekturstruktur aus dem ersten Bild bei und zeichne sie mit den Aquarellpinselstrichen und der Farbpalette des zweiten Bildes neu",
    "image_urls": [
      "https://example.com/building.jpg",
      "https://example.com/watercolor.jpg"
    ],
    "resolution": "1.5K",
    "output_format": "png"
  }
}

Nach erfolgreicher Erstellung fragst du mit der zurückgegebenen Aufgaben-ID über GET https://api.hiapi.ai/v1/tasks/{taskId} das Ergebnis ab und entnimmst nach Erfolg die Bildadresse aus der Ausgabe.

Anwendungsempfehlungen

• Erst klein, dann groß: Teste den Prompt mit 768 oder 1K und festem seed; wenn du zufrieden bist, ändere nur resolution auf 2K oder 4K und erzeuge das Bild erneut.
• Massenvarianten: Derselbe Prompt mit unterschiedlichen seed-Werten ergibt eine Gruppe von Kandidaten mit unterschiedlicher Komposition und konsistentem Stil.
• Bei Bildbearbeitung klar angeben, was erhalten bleiben soll: Bei Referenzbildern im Prompt zu nennen, was beibehalten und was geändert werden soll, ist stabiler, als nur das Zielbild zu beschreiben.

Aktuelle Einschränkungen

• Jeder Aufruf liefert ein Bild.
• Maximal 10 Referenzbilder, die öffentlich über http(s) erreichbar sein müssen.
• Es gibt keine Option für transparenten Hintergrund; png ist lediglich ein anderes verlustfreies Format.