Black Forest LabsTutorial
So verwenden Sie die FLUX 3 Image Klein-API
Eine Schritt-für-Schritt-Anleitung zur FLUX 3 Image Klein-API mit Node.js, Python und cURL: einen text zu bild-Auftrag absenden, den Status abfragen oder einen Webhook empfangen und anschließend die image herunterladen. Das folgende Beispiel kostet $0,002.
- Endpunkte
- 2
- Text zu Bild · Bildbearbeitung
- Beispielanfrage
- $0,002
- Text zu Bild
- Sprachen
- 3
- Node.js · Python · cURL
- Fehlgeschlagene Aufträge
- $0
- automatisch erstattet
API-Schlüssel abrufen
Erstellen Sie ein Konto, laden Sie Guthaben auf und erstellen Sie im Dashboard unter „API-Schlüssel“ einen Schlüssel. Speichern Sie ihn als CHEAPERGEN_API_KEY auf Ihrem Server. Jede Anfrage sendet ihn als Bearer-Token.
Wählen Sie einen FLUX 3 Image Klein-Endpunkt
Jede Aufgabe hat einen eigenen Endpunkt. Alle erwarten einen JSON-Body und geben eine Generierung zurück, deren Status Sie abfragen können.
| Aufgabe | Endpunkt | Erforderlich | Ab |
|---|---|---|---|
| Text zu Bild | bfl/flux-3-image-klein/text-to-image | prompt | $0,0011 pro Bild |
| Bildbearbeitung | bfl/flux-3-image-klein/edit | prompt, image_urls | $0,0011 pro Bild |
Einen text zu bild-Auftrag absenden
Dieses Programm übermittelt den Auftrag, fragt alle 3 Sekunden bis zum Abschluss den Status ab und gibt die image-URL aus. Ersetzen Sie Prompt und Einstellungen durch Ihre eigenen.
const API = "https://cheapergen.com/api/v1";
const headers = {
Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
"Content-Type": "application/json",
};
// 1. Submit the job
let job = await fetch(`${API}/run/bfl/flux-3-image-klein/text-to-image`, {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "Redaktionelles Stillleben: handgedrehte Terrakottavase mit getrockneten orangefarbenen Ranunkeln auf einem Travertinsockel, tief stehende goldene Sonne von links, lange weiche Schatten auf einer warmen Putzwand, Mittelformat-Filmfoto",
"aspect_ratio": "1:1",
"resolution": "1K"
}),
}).then((r) => r.json());
// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
await new Promise((r) => setTimeout(r, 3000));
job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}
console.log(job.status === "succeeded" ? job.output.images[0].url : job.error);Wichtige Parameter festlegen
Die Einstellungen für bfl/flux-3-image-klein/text-to-image und ihre Auswirkungen auf den Preis.
| Parameter | Typ · Standardwert | Beschreibung | Preisauswirkung |
|---|---|---|---|
| aspect_ratio | string (enum) · 1:1 | Ausgabeformat des Bildes. 1:1 · 4:5 · 3:4 · 2:3 · 9:16 · 1:2 · 9:21 · 5:4 · 4:3 · 3:2 · 16:9 · 2:1 · 21:9 · 7:5 · 5:7 | 1:1: $0,0011 pro Bild |
| resolution | string (enum) · 1K | Ausgabegrößen: 768 ≈ 0.6 MP, 1K ≈ 1 MP, 1.5K ≈ 2.4 MP, 2K ≈ 4 MP, 4K ≈ 16 MP. Bis 2K bleibt die lange Seite bei Quer- und Hochformat bei höchstens 2048 px; für 4K gilt 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, 9:21. 768 · 1K · 1.5K · 2K · 4K | 768: $0,0011 pro Bild 1K: $0,0019 pro Bild 1.5K: $0,0043 pro Bild 2K: $0,0074 pro Bild 4K: $0,0342 pro Bild |
| seed | integer | Verwenden Sie denselben Seed und dieselben Einstellungen, um ein Ergebnis zu reproduzieren. Leer lassen für Zufallswerte. | Keine |
| enable_safety_checker | boolean · true | Wenn true festgelegt ist, wird die Sicherheitsprüfung aktiviert. Inhalte, die unsere Richtlinie zur zulässigen Nutzung verbietet, bleiben in jedem Fall blockiert. | Keine |
Weitere FLUX 3 Image Klein-Endpunkte verwenden dieselbe Struktur, aber jeweils eigene Eingabefelder:
POST /api/v1/run/bfl/flux-3-image-klein/edit
{
"prompt": "Setze die Lampe aus Bild 2 auf den Schreibtisch in Bild 1. Raum, Licht und Kamerawinkel sollen unverändert bleiben.",
"image_urls": [
"https://cdn.cheapergen.com/samples/portrait.jpg"
],
"aspect_ratio": "auto",
"resolution": "1K"
}Ergebnis abrufen
Ein Auftrag wechselt von queued zu running und anschließend zu succeeded, failed oder canceled. Fragen Sie GET /api/v1/generations/{id} ab oder übergeben Sie webhook_url; dann senden wir Ihnen das Ergebnis per POST. Laden Sie die Ausgabe herunter und speichern Sie sie selbst.
200 — succeeded
{
"id": "gen_8c2QmX1nq0k4",
"object": "generation",
"model": "bfl/flux-3-image-klein",
"endpoint": "bfl/flux-3-image-klein/text-to-image",
"mode": "text-to-image",
"status": "succeeded",
"input": {
"prompt": "Redaktionelles Stillleben: handgedrehte Terrakottavase mit getrockneten orangefarbenen Ranunkeln auf einem Travertinsockel, tief stehende goldene Sonne von links, lange weiche Schatten auf einer warmen Putzwand, Mittelformat-Filmfoto",
"aspect_ratio": "1:1",
"resolution": "1K"
},
"output": {
"images": [
{
"url": "https://cdn.cheapergen.com/outputs/gen_8c2Q-0.png",
"content_type": "image/png",
"width": 2048,
"height": 2048
}
]
},
"error": null,
"cost": {
"amount_usd": 0.2255,
"currency": "usd",
"estimated": false,
"official_usd": 0.264,
"list_price_source": "official",
"list_price_label": "Official",
"saved_usd": 0.0385
},
"source": "api",
"created_at": "2026-10-15T09:21:04Z",
"started_at": "2026-10-15T09:21:06Z",
"completed_at": "2026-10-15T09:22:31Z"
}Preis vor der Ausführung abfragen
Der Angebotsendpunkt ist kostenlos und erfordert keinen Schlüssel. Er gibt den Preis, der offizielle Preis und Ihren Rabatt genau für die übermittelten Eingaben zurück.
curl -X POST https://cheapergen.com/api/v1/quote/bfl/flux-3-image-klein/text-to-image \
-H "Content-Type: application/json" \
-d '{"prompt":"Redaktionelles Stillleben: handgedrehte Terrakottavase mit getrockneten orangefarbenen Ranunkeln auf einem Travertinsockel, tief stehende goldene Sonne von links, lange weiche Schatten auf einer warmen Putzwand, Mittelformat-Filmfoto","aspect_ratio":"1:1","resolution":"1K"}'| Status | Code | Bedeutung |
|---|---|---|
| 400 | invalid_request | Ein Parameter fehlt oder liegt außerhalb des zulässigen Bereichs – die Meldung nennt ihn. |
| 401 | unauthorized | API-Schlüssel fehlt, ist fehlerhaft formatiert oder wurde widerrufen. |
| 402 | insufficient_balance | Ihr Guthaben reicht nicht für den angebotenen Preis. Laden Sie es auf oder aktivieren Sie die automatische Aufladung. |
| 429 | rate_limited | Zu viele Anfragen oder gleichzeitig laufende Generierungen. Warten Sie kurz und versuchen Sie es erneut. |
| 502 | upstream_error | Die Verarbeitung durch das Modell ist fehlgeschlagen. Der reservierte Betrag wird erstattet; Sie können es erneut versuchen. |
| 503 | model_unavailable | Derzeit ist kein geeigneter Verarbeitungsweg verfügbar. Versuchen Sie es später erneut oder wählen Sie ein anderes Modell. |
FAQ
FLUX 3 Image Klein-API: häufige Fragen
Nein. Die API verwendet einfaches HTTPS mit JSON. Die Beispiele für Node.js (fetch) und Python (requests) auf dieser Seite sind vollständige Programme. Jede Sprache, die HTTP-Anfragen senden kann, funktioniert.
Ja. Fügen Sie „webhook_url“ in den Anfrage-Body ein. Wir senden die abgeschlossene Generierung dann signiert an diese Adresse, mit dem Header CheaperGen-Signature (HMAC-SHA256 aus Zeitstempel und rohem Body). GET /api/v1/generations/{id} zum Abfragen des Status funktioniert ebenfalls.
Übergeben Sie öffentliche URLs in "image_urls". Dateien ohne öffentliche URL können Sie zuerst mit POST /api/v1/uploads hochladen. Der Aufruf gibt eine URL zurück, die Sie in der Anfrage verwenden.
Text zu Bild kostet ab $0,0011 pro Bild; die Beispielanfrage auf dieser Seite kostet $0,002, 79% unter der offizielle Preis. Fehlgeschlagene Generierungen werden automatisch erstattet.