FLUX.2 [flex] ist Black Forest Labs’ Edition für Bildgenerierung und -bearbeitung mit Schwerpunkt auf Typografie, Textdarstellung und dem Erhalten kleiner Details. Sie erzeugt aus schriftlichen Szenenanweisungen und Bildreferenzen ein Bild. Ihr kennzeichnendes Steuerelement ist verstellbares Sampling: Das dokumentierte Profil legt Inferenzschritte und Guidance offen, sodass sich ein Bildbriefing über Einstellungen und Wörter verfeinern lässt.
Eine Typografieaufgabe sollte mit dem tatsächlichen Text beginnen. Zitieren Sie jede Zeile, definieren Sie ihre Position und unterscheiden Sie Überschrift, unterstützenden Text und Beschriftung. Beschreiben Sie Schriftstil, Massstab und Farbe im Verhältnis zur Szene. Ein eigenes Plakatbriefing könnte ein kobaltblaues Velo in einem hellen Studio zeigen, mit grossem Titel darüber und einer kleineren Spezifikationszeile darunter. Das Bild muss Produkt und Lesereihenfolge gemeinsam deutlich machen.
Benennen Sie bei einem detaillierten Produktvisual die Teile, die über seine Brauchbarkeit entscheiden: Zifferblatt, Bedienbeschriftung, Naht, Materialkante oder Verpackungskennzeichnung. Liefern Sie eine lesbare Referenz und erklären Sie, welches Merkmal sie vorgibt. Eine insgesamt ähnliche Szene kann dennoch ein entscheidendes Zeichen oder Bauteil verändern; vergleichen Sie daher das generierte Detail in der vorgesehenen Anzeigegrösse. Die Spezialisierung des Modells ist ein Grund für genaue Anforderungen und keine Garantie, dass Korrekturlesen oder Sichtprüfung entfallen.
Das genaue Herstellerprofil akzeptiert ein bis fünfzig Inferenzschritte, standardmässig fünfzig. Seine Beschreibung verbindet mehr Schritte mit grösserer Detailtiefe und stärkerem Realismus. Guidance reicht von 1.5 bis 10, standardmässig 5. Höhere Guidance verstärkt die Prompt-Befolgung, kann aber den Realismus verringern. Ein Bild mit exakten Designanweisungen und eines mit dem Ziel einer natürlichen fotografischen Wirkung können daher unterschiedliche Entscheidungen innerhalb dieses Profils erfordern.
Halten Sie Wortlaut, Referenzen und Ausgabeformat beim Vergleich einer Einstellungsänderung konstant. Betrachten Sie das Merkmal, das die Änderung veranlasst hat: Buchstabenformen, Objektplatzierung oder Materialtextur. Ändern Sie eine Einstellung aus einem konkreten Bildgrund, statt eine hohe Zahl automatisch als besser anzusehen. Dies sind Sampling-Steuerungen des Herstellers; das vierstufige destillierte [klein]-Profil und die Standardsteuerungen von [pro] oder [max] sind andere Modellentscheidungen.
Prompt-Upsampling ist in der [flex]-Spezifikation standardmässig aktiv und kann über die eigene Steuerung prompt_upsampling deaktiviert werden. So bleibt ein detailliertes Briefing bei Bedarf der gelieferte Text. Der gemeinsame Herstellerleitfaden empfiehlt, Hauptmotiv und wichtige Handlung vor sekundärer Dekoration zu platzieren, und beschreibt JSON-strukturierte Prompts neben natürlichsprachlichen Briefings. Nutzen Sie die Struktur, in der sich die erforderlichen Beziehungen am einfachsten angeben lassen.
Das genaue Anfrageprofil enthält acht Referenzbildpositionen. Der interaktive Herstellerablauf erlaubt separat bis zu zehn Bilder; diese Zahlen beschreiben unterschiedliche Schnittstellen. Definieren Sie, ob ein Bild die zu bearbeitende Szene, ein Produkt, eine Figur, Kleidung oder einen Stil liefert. Benennen Sie bei einer Überarbeitung Objekt und Änderung und danach die umgebende Komposition, Materialien oder Beleuchtung, die erhalten bleiben sollen.
Eine eigene Verpackungsaufgabe könnte den Karton aus dem ersten Bild und das Finish aus einem zweiten nutzen, das Vorderetikett durch den freigegebenen Wortlaut ersetzen und die Kartonproportionen erhalten. Eine Gruppenkomposition kann jedem Motiv eine eigene Referenz zuweisen und diese Zuordnungen konsistent halten. Die Familienbeispiele umfassen Objekt- und Hintergrundwechsel, Montagen, Textbearbeitung und Stiltransformationen. Fordern Sie eine zusammenhängende Überarbeitung mit klarem Ziel an und vergleichen Sie bearbeiteten Bereich sowie stabil zu haltende Teile.
Der FLUX.2-Leitfaden dokumentiert mindestens 64×64 Pixel, Abmessungen in Vielfachen von 16 und Ausgabe bis 4 Megapixel; für gewöhnliche Nutzung werden bis 2 Megapixel empfohlen. Die genaue [flex]-Spezifikation nennt JPEG, PNG und WebP, standardmässig JPEG. Sie bietet auch einen optionalen Zufalls-Seed. Bewahren Sie beim Versionsvergleich tatsächliches Modell, Seed und Sampling-Einstellungen mit den Quellreferenzen auf; eine Familienbezeichnung allein identifiziert nicht die gesamte Generierungskonfiguration.
Ordnen Sie bei farbkritischer Arbeit jeden Hex-Code einem benannten Objekt oder Textelement zu. Geben Sie für die Komposition das gewünschte Seitenverhältnis über die Bildabmessungen an und lassen Sie genügend Platz für lesbare Schrift. Der gemeinsame Leitfaden hat keinen Mechanismus für negative Prompts; beschreiben Sie die gewünschte Erscheinung deshalb positiv: scharfer Fokus, sauberer Hintergrund oder ein klar freier Textbereich. Seine mehrsprachigen Beispiele unterstützen kulturbezogene Briefings in der passenden Sprache, ohne eine feste Anzahl unterstützter Sprachen zu garantieren.
Der FLUX.2-Ablauf des Herstellers liefert nach der Verarbeitung ein Bild und verwendet temporäre signierte Links mit zehn Minuten Abruffenster. Bewahren Sie tatsächliches Bild und Briefing gemeinsam auf. Prüfen Sie Typografie, feine Details, Referenzidentität und Bildgestaltung vor dem Einsetzen ins Layout. Das fertige Ergebnis kann ein ausgewähltes Plakat, Produktbild oder eine bearbeitete Komposition sein, deren genaue Einstellungen für die nächste Überarbeitung erhalten bleiben.
", "aboutText": "FLUX.2 [flex] ist Black Forest Labs’ Edition für Bildgenerierung und -bearbeitung mit Schwerpunkt auf Typografie, Textdarstellung und dem Erhalten kleiner Details. Sie erzeugt aus schriftlichen Szenenanweisungen und Bildreferenzen ein Bild. Ihr kennzeichnendes Steuerelement ist verstellbares Sampling: Das dokumentierte Profil legt Inferenzschritte und Guidance offen, sodass sich ein Bildbriefing über Einstellungen und Wörter verfeinern lässt.\n\n### Schrift und feine Details\n\nEine Typografieaufgabe sollte mit dem tatsächlichen Text beginnen. Zitieren Sie jede Zeile, definieren Sie ihre Position und unterscheiden Sie Überschrift, unterstützenden Text und Beschriftung. Beschreiben Sie Schriftstil, Massstab und Farbe im Verhältnis zur Szene. Ein eigenes Plakatbriefing könnte ein kobaltblaues Velo in einem hellen Studio zeigen, mit grossem Titel darüber und einer kleineren Spezifikationszeile darunter. Das Bild muss Produkt und Lesereihenfolge gemeinsam deutlich machen.\n\nBenennen Sie bei einem detaillierten Produktvisual die Teile, die über seine Brauchbarkeit entscheiden: Zifferblatt, Bedienbeschriftung, Naht, Materialkante oder Verpackungskennzeichnung. Liefern Sie eine lesbare Referenz und erklären Sie, welches Merkmal sie vorgibt. Eine insgesamt ähnliche Szene kann dennoch ein entscheidendes Zeichen oder Bauteil verändern; vergleichen Sie daher das generierte Detail in der vorgesehenen Anzeigegrösse. Die Spezialisierung des Modells ist ein Grund für genaue Anforderungen und keine Garantie, dass Korrekturlesen oder Sichtprüfung entfallen.\n\n### Schritte und Guidance erfüllen verschiedene Aufgaben\n\nDas genaue Herstellerprofil akzeptiert ein bis fünfzig Inferenzschritte, standardmässig fünfzig. Seine Beschreibung verbindet mehr Schritte mit grösserer Detailtiefe und stärkerem Realismus. Guidance reicht von 1.5 bis 10, standardmässig 5. Höhere Guidance verstärkt die Prompt-Befolgung, kann aber den Realismus verringern. Ein Bild mit exakten Designanweisungen und eines mit dem Ziel einer natürlichen fotografischen Wirkung können daher unterschiedliche Entscheidungen innerhalb dieses Profils erfordern.\n\nHalten Sie Wortlaut, Referenzen und Ausgabeformat beim Vergleich einer Einstellungsänderung konstant. Betrachten Sie das Merkmal, das die Änderung veranlasst hat: Buchstabenformen, Objektplatzierung oder Materialtextur. Ändern Sie eine Einstellung aus einem konkreten Bildgrund, statt eine hohe Zahl automatisch als besser anzusehen. Dies sind Sampling-Steuerungen des Herstellers; das vierstufige destillierte [klein]-Profil und die Standardsteuerungen von [pro] oder [max] sind andere Modellentscheidungen.\n\nPrompt-Upsampling ist in der [flex]-Spezifikation standardmässig aktiv und kann über die eigene Steuerung prompt_upsampling deaktiviert werden. So bleibt ein detailliertes Briefing bei Bedarf der gelieferte Text. Der gemeinsame Herstellerleitfaden empfiehlt, Hauptmotiv und wichtige Handlung vor sekundärer Dekoration zu platzieren, und beschreibt JSON-strukturierte Prompts neben natürlichsprachlichen Briefings. Nutzen Sie die Struktur, in der sich die erforderlichen Beziehungen am einfachsten angeben lassen.\n\n### Referenzgestützte Überarbeitungen\n\nDas genaue Anfrageprofil enthält acht Referenzbildpositionen. Der interaktive Herstellerablauf erlaubt separat bis zu zehn Bilder; diese Zahlen beschreiben unterschiedliche Schnittstellen. Definieren Sie, ob ein Bild die zu bearbeitende Szene, ein Produkt, eine Figur, Kleidung oder einen Stil liefert. Benennen Sie bei einer Überarbeitung Objekt und Änderung und danach die umgebende Komposition, Materialien oder Beleuchtung, die erhalten bleiben sollen.\n\nEine eigene Verpackungsaufgabe könnte den Karton aus dem ersten Bild und das Finish aus einem zweiten nutzen, das Vorderetikett durch den freigegebenen Wortlaut ersetzen und die Kartonproportionen erhalten. Eine Gruppenkomposition kann jedem Motiv eine eigene Referenz zuweisen und diese Zuordnungen konsistent halten. Die Familienbeispiele umfassen Objekt- und Hintergrundwechsel, Montagen, Textbearbeitung und Stiltransformationen. Fordern Sie eine zusammenhängende Überarbeitung mit klarem Ziel an und vergleichen Sie bearbeiteten Bereich sowie stabil zu haltende Teile.\n\n### Grösse, Farbe und zurückgegebenes Bild\n\nDer FLUX.2-Leitfaden dokumentiert mindestens 64×64 Pixel, Abmessungen in Vielfachen von 16 und Ausgabe bis 4 Megapixel; für gewöhnliche Nutzung werden bis 2 Megapixel empfohlen. Die genaue [flex]-Spezifikation nennt JPEG, PNG und WebP, standardmässig JPEG. Sie bietet auch einen optionalen Zufalls-Seed. Bewahren Sie beim Versionsvergleich tatsächliches Modell, Seed und Sampling-Einstellungen mit den Quellreferenzen auf; eine Familienbezeichnung allein identifiziert nicht die gesamte Generierungskonfiguration.\n\nOrdnen Sie bei farbkritischer Arbeit jeden Hex-Code einem benannten Objekt oder Textelement zu. Geben Sie für die Komposition das gewünschte Seitenverhältnis über die Bildabmessungen an und lassen Sie genügend Platz für lesbare Schrift. Der gemeinsame Leitfaden hat keinen Mechanismus für negative Prompts; beschreiben Sie die gewünschte Erscheinung deshalb positiv: scharfer Fokus, sauberer Hintergrund oder ein klar freier Textbereich. Seine mehrsprachigen Beispiele unterstützen kulturbezogene Briefings in der passenden Sprache, ohne eine feste Anzahl unterstützter Sprachen zu garantieren.\n\nDer FLUX.2-Ablauf des Herstellers liefert nach der Verarbeitung ein Bild und verwendet temporäre signierte Links mit zehn Minuten Abruffenster. Bewahren Sie tatsächliches Bild und Briefing gemeinsam auf. Prüfen Sie Typografie, feine Details, Referenzidentität und Bildgestaltung vor dem Einsetzen ins Layout. Das fertige Ergebnis kann ein ausgewähltes Plakat, Produktbild oder eine bearbeitete Komposition sein, deren genaue Einstellungen für die nächste Überarbeitung erhalten bleiben.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "cb9e6b8d5e52c9b735e0d6e8d4c6d5d0eee63c0193562f80e1a0c5e2bf36cfd9", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "de-ch", "methods": [ { "html": "black-forest-labs/flux.2-flexFLUX.2 [flex] spezialisiert sich auf Bildtypografie und kleine visuelle Details mit verstellbaren Sampling-Schritten und Guidance. Nutzen Sie Text und Bildreferenzen für Plakate, Produktlayouts oder präzise Überarbeitungen und stimmen Sie dabei Anweisungstreue und Realismus aufeinander ab.
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
FLUX.2 [flex] ist Black Forest Labs’ Edition für Bildgenerierung und -bearbeitung mit Schwerpunkt auf Typografie, Textdarstellung und dem Erhalten kleiner Details. Sie erzeugt aus schriftlichen Szenenanweisungen und Bildreferenzen ein Bild. Ihr kennzeichnendes Steuerelement ist verstellbares Sampling: Das dokumentierte Profil legt Inferenzschritte und Guidance offen, sodass sich ein Bildbriefing über Einstellungen und Wörter verfeinern lässt.
Eine Typografieaufgabe sollte mit dem tatsächlichen Text beginnen. Zitieren Sie jede Zeile, definieren Sie ihre Position und unterscheiden Sie Überschrift, unterstützenden Text und Beschriftung. Beschreiben Sie Schriftstil, Massstab und Farbe im Verhältnis zur Szene. Ein eigenes Plakatbriefing könnte ein kobaltblaues Velo in einem hellen Studio zeigen, mit grossem Titel darüber und einer kleineren Spezifikationszeile darunter. Das Bild muss Produkt und Lesereihenfolge gemeinsam deutlich machen.
Benennen Sie bei einem detaillierten Produktvisual die Teile, die über seine Brauchbarkeit entscheiden: Zifferblatt, Bedienbeschriftung, Naht, Materialkante oder Verpackungskennzeichnung. Liefern Sie eine lesbare Referenz und erklären Sie, welches Merkmal sie vorgibt. Eine insgesamt ähnliche Szene kann dennoch ein entscheidendes Zeichen oder Bauteil verändern; vergleichen Sie daher das generierte Detail in der vorgesehenen Anzeigegrösse. Die Spezialisierung des Modells ist ein Grund für genaue Anforderungen und keine Garantie, dass Korrekturlesen oder Sichtprüfung entfallen.
Das genaue Herstellerprofil akzeptiert ein bis fünfzig Inferenzschritte, standardmässig fünfzig. Seine Beschreibung verbindet mehr Schritte mit grösserer Detailtiefe und stärkerem Realismus. Guidance reicht von 1.5 bis 10, standardmässig 5. Höhere Guidance verstärkt die Prompt-Befolgung, kann aber den Realismus verringern. Ein Bild mit exakten Designanweisungen und eines mit dem Ziel einer natürlichen fotografischen Wirkung können daher unterschiedliche Entscheidungen innerhalb dieses Profils erfordern.
Halten Sie Wortlaut, Referenzen und Ausgabeformat beim Vergleich einer Einstellungsänderung konstant. Betrachten Sie das Merkmal, das die Änderung veranlasst hat: Buchstabenformen, Objektplatzierung oder Materialtextur. Ändern Sie eine Einstellung aus einem konkreten Bildgrund, statt eine hohe Zahl automatisch als besser anzusehen. Dies sind Sampling-Steuerungen des Herstellers; das vierstufige destillierte [klein]-Profil und die Standardsteuerungen von [pro] oder [max] sind andere Modellentscheidungen.
Prompt-Upsampling ist in der [flex]-Spezifikation standardmässig aktiv und kann über die eigene Steuerung prompt_upsampling deaktiviert werden. So bleibt ein detailliertes Briefing bei Bedarf der gelieferte Text. Der gemeinsame Herstellerleitfaden empfiehlt, Hauptmotiv und wichtige Handlung vor sekundärer Dekoration zu platzieren, und beschreibt JSON-strukturierte Prompts neben natürlichsprachlichen Briefings. Nutzen Sie die Struktur, in der sich die erforderlichen Beziehungen am einfachsten angeben lassen.
Das genaue Anfrageprofil enthält acht Referenzbildpositionen. Der interaktive Herstellerablauf erlaubt separat bis zu zehn Bilder; diese Zahlen beschreiben unterschiedliche Schnittstellen. Definieren Sie, ob ein Bild die zu bearbeitende Szene, ein Produkt, eine Figur, Kleidung oder einen Stil liefert. Benennen Sie bei einer Überarbeitung Objekt und Änderung und danach die umgebende Komposition, Materialien oder Beleuchtung, die erhalten bleiben sollen.
Eine eigene Verpackungsaufgabe könnte den Karton aus dem ersten Bild und das Finish aus einem zweiten nutzen, das Vorderetikett durch den freigegebenen Wortlaut ersetzen und die Kartonproportionen erhalten. Eine Gruppenkomposition kann jedem Motiv eine eigene Referenz zuweisen und diese Zuordnungen konsistent halten. Die Familienbeispiele umfassen Objekt- und Hintergrundwechsel, Montagen, Textbearbeitung und Stiltransformationen. Fordern Sie eine zusammenhängende Überarbeitung mit klarem Ziel an und vergleichen Sie bearbeiteten Bereich sowie stabil zu haltende Teile.
Der FLUX.2-Leitfaden dokumentiert mindestens 64×64 Pixel, Abmessungen in Vielfachen von 16 und Ausgabe bis 4 Megapixel; für gewöhnliche Nutzung werden bis 2 Megapixel empfohlen. Die genaue [flex]-Spezifikation nennt JPEG, PNG und WebP, standardmässig JPEG. Sie bietet auch einen optionalen Zufalls-Seed. Bewahren Sie beim Versionsvergleich tatsächliches Modell, Seed und Sampling-Einstellungen mit den Quellreferenzen auf; eine Familienbezeichnung allein identifiziert nicht die gesamte Generierungskonfiguration.
Ordnen Sie bei farbkritischer Arbeit jeden Hex-Code einem benannten Objekt oder Textelement zu. Geben Sie für die Komposition das gewünschte Seitenverhältnis über die Bildabmessungen an und lassen Sie genügend Platz für lesbare Schrift. Der gemeinsame Leitfaden hat keinen Mechanismus für negative Prompts; beschreiben Sie die gewünschte Erscheinung deshalb positiv: scharfer Fokus, sauberer Hintergrund oder ein klar freier Textbereich. Seine mehrsprachigen Beispiele unterstützen kulturbezogene Briefings in der passenden Sprache, ohne eine feste Anzahl unterstützter Sprachen zu garantieren.
Der FLUX.2-Ablauf des Herstellers liefert nach der Verarbeitung ein Bild und verwendet temporäre signierte Links mit zehn Minuten Abruffenster. Bewahren Sie tatsächliches Bild und Briefing gemeinsam auf. Prüfen Sie Typografie, feine Details, Referenzidentität und Bildgestaltung vor dem Einsetzen ins Layout. Das fertige Ergebnis kann ein ausgewähltes Plakat, Produktbild oder eine bearbeitete Komposition sein, deren genaue Einstellungen für die nächste Überarbeitung erhalten bleiben.
POST /v1/images/generationstext, imageimage| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits black-forest-labs/flux.2-flex | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits Mindestlänge: 1 | Standard— |
Feldaspect_ratio | Typstring | AnforderungOptional | Werte und Limits 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto | Standard— |
Feldoutput_format | Typstring | AnforderungOptional | Werte und Limits png, jpeg | Standard— |
Feldn | Typinteger | AnforderungOptional | Werte und Limits Minimum: 1 Maximum: 1 | Standard— |
Feldinput_references | Typarray | AnforderungOptional | Werte und Limits Mindestanzahl Elemente: 0 Maximale Anzahl Elemente: 8 | Standard— |
Feldprovider | Typobject | AnforderungOptional | Werte und Limits | Standard— |
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, prompt |
Parametermaterial_types | Vertragtext, image |
Lebenszyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · die tatsächlich zurückgegebene task_id oder ein Eintrag in der Medienbibliothek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Tarifstaffel | Prognostizierte Menge | Abrechnungseinheit | Gebühr |
|---|---|---|---|---|
| KonfigurationToken-Basistarife | TarifstaffelGrundtarif | Prognostizierte Menge— | Abrechnungseinheit— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Tokens Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache lesen · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Tokens |
| KonfigurationMegapixel des Eingabebilds | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Megapixel des Eingabebildes | Gebühr Eingabe · Megapixel des Eingabebilds · Schätzung nur zum Vergleich $0.12 pro Megapixel des Eingabebildes |
| KonfigurationMegapixel des Ausgabebilds | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Megapixel des Ausgabebildes | Gebühr Ausgabe · Megapixel des Ausgabebilds · Schätzung nur zum Vergleich $0.12 pro Megapixel des Ausgabebildes |
| KonfigurationGeschätzte Erzeugungskosten | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Abrechnungseinheit— | Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.12 Schätzung vor der Generierung Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung. |
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschliessenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'black-forest-labs/flux.2-flex', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nLaden Sie jedes zurückgegebene Bild herunter oder speichern Sie seinen Base64-Inhalt
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nSpeichern Sie jedes fertiggestellte Bild; rufen Sie jede zurückgegebene URL ab oder dekodieren Sie seinen Base64-Inhalt.
Die vollständige Antwort und ihre Header, jede tatsächliche Ausgabe, die ursprünglich zurückgegebenen Kennungen und alle Nutzungsfelder aufbewahren. Den ursprünglichen Vorgang wiederaufnehmen, ohne die Erstellung erneut anzufordern.
Die zurückgegebene X-Client-Request-ID zum Abgleich aufbewahren. Nur tatsächlich zurückgegebene task_id-/asset_id-Werte oder die eigene Medienbibliothek abfragen; niemals eine Aufgaben-URL aus der Vorgangs-ID bilden und die Erstellung niemals erneut anfordern.
| Feld | Typ |
|---|---|
Feldcreated | Typ |
Felddata[].url | Typ |
Felddata[].b64_json | Typ |
Feldusage | Typ |
Ailoot Ultra black-forest-labs/flux.2-flex
/v1/images