{ "aboutHtml": "

Recraft V4.1 Flash ist Recrafts Text-zu-Bild-Modell für schnelle Iterationen und visuelle Arbeit mit hohem Volumen. Der Hersteller nennt Fotografie, Porträts, Atmosphäre, komplexe Szenen, Mixed Media und Logokonzepte als starke Einsatzgebiete. Ein schriftliches Briefing wird zu einem Rasterbild, das sich mit anderen kreativen Richtungen vergleichen lässt, bevor ein fertiges Bild ausgearbeitet wird. Flash ist ein bestimmtes Mitglied der V4.1-Familie mit eigener Ausgabegrösse und eigenen unterstützten Einstellungen.

Die native Ausgabe gehört zu Recrafts 1K-Rasterbildklasse. Wählen Sie die Bildfläche passend zum vorgesehenen Einsatz: eine horizontale Illustration für einen Seitenkopf, ein vertikales Porträt oder ein quadratisches Motiv für eine kompakte Karte. Als Ausgabeformate stehen verlustfreies WebP und PNG zur Verfügung.

Beginnen Sie das Briefing mit dem Hauptmotiv und dem visuellen Zweck und beschreiben Sie danach Bildausschnitt, Umgebung, Beleuchtung und Medium. Eine hilfreiche Anweisung für ein Produktkonzept lautet: «Ein kompaktes cremefarbenes Radio auf einem Schreibtisch aus Nussbaumholz, vordere Dreiviertelansicht, weiches Fensterlicht, ruhige redaktionelle Fotografie, grosszügiger Freiraum links.» Benennen Sie für eine Illustration die Formensprache, die Palette und die Beziehungen zwischen den Elementen. Halten Sie die Details, die die Idee bestimmen, ausdrücklich fest, statt unzusammenhängende Adjektive hinzuzufügen. Flash erlaubt laut Dokumentation Prompts mit bis zu 10'000 Zeichen, sodass sich eine detaillierte Szene beschreiben lässt, wenn die Aufgabe das erfordert.

Zu den Herstellereinstellungen gehören bevorzugte Farben und eine gewünschte Hintergrundfarbe. Ein Seed kann für reproduzierbare Ergebnisse angegeben werden; die Generierungsschnittstelle dokumentiert ein bis sechs Bilder pro Anfrage. Diese Einstellungen ermöglichen eine sinnvolle Vergleichsaufgabe: Motiv und Komposition konstant halten, eine visuelle Richtung variieren und die entstehenden Bilder für das vorgesehene Layout prüfen. Farbwünsche beschreiben das angeforderte Ergebnis; vergleichen Sie wichtige Markenfarben mit dem fertigen Bild, bevor Sie es mit einem bestehenden Designsystem kombinieren.

Flash erzeugt Rastergrafiken. Ein Logokonzept kann helfen, Silhouette, Stimmung oder Anordnung auszuwählen; bearbeitbare Pfade gehören dagegen zu den separat benannten Vector-Modellen. Flash hat zudem keine Pro-Variante. Die vollständige V4.1-Reihe bietet diese gesonderten Optionen, wenn Vektorbearbeitung oder höher auflösende Details für das Ergebnis entscheidend sind. Der Hersteller beschreibt einen späteren Verfeinerungsschritt, der einen gewählten Entwurf zu einem detaillierteren Bild weiterentwickelt; dieser Schritt ist eine eigenständige Operation und keine andere native Flash-Ausgabegrösse.

Diese Ausgabe unterstützt weder Bild-zu-Bild-Eingaben noch benutzerdefinierte Stile, Stilkennungen, Stilabgleich oder Stilreferenzbilder. Ihre dokumentierte Schnittstelle schliesst ausserdem negative Prompts und ausdrückliche Textlayout-Einstellungen aus. Beschreiben Sie das gewünschte Erscheinungsbild und die Komposition im positiven Briefing. Wenn Schrift zu einem Konzept gehört, zitieren Sie den gewünschten Wortlaut und prüfen Sie die gerenderten Buchstaben; nutzen Sie eine separate Layoutphase, wenn exakte Typografie und Platzierung entscheidend sind.

Ein praktisches Ergebnis von Flash ist eine ausgewählte visuelle Richtung mit klarem Briefing, passendem Seitenverhältnis und nutzbarer Rasterdatei. Vergleichen Sie Motiv, Bildausschnitt, Hintergrund und wichtige Details in der Grösse, in der das Bild erscheinen wird. Bewahren Sie den erfolgreichen Prompt gemeinsam mit der gewählten Datei auf, damit der nächste kreative Schritt der ausgewählten Richtung folgt. Schnelle Iterationen helfen, das Design zu erkunden; native Vektorausgabe, Stilabgleich anhand von Referenzen und die Auflösung einer anderen V4.1-Ausgabe bleiben getrennte Modellentscheidungen.

", "aboutText": "Recraft V4.1 Flash ist Recrafts Text-zu-Bild-Modell für schnelle Iterationen und visuelle Arbeit mit hohem Volumen. Der Hersteller nennt Fotografie, Porträts, Atmosphäre, komplexe Szenen, Mixed Media und Logokonzepte als starke Einsatzgebiete. Ein schriftliches Briefing wird zu einem Rasterbild, das sich mit anderen kreativen Richtungen vergleichen lässt, bevor ein fertiges Bild ausgearbeitet wird. Flash ist ein bestimmtes Mitglied der V4.1-Familie mit eigener Ausgabegrösse und eigenen unterstützten Einstellungen.\n\nDie native Ausgabe gehört zu Recrafts 1K-Rasterbildklasse. Wählen Sie die Bildfläche passend zum vorgesehenen Einsatz: eine horizontale Illustration für einen Seitenkopf, ein vertikales Porträt oder ein quadratisches Motiv für eine kompakte Karte. Als Ausgabeformate stehen verlustfreies WebP und PNG zur Verfügung.\n\nBeginnen Sie das Briefing mit dem Hauptmotiv und dem visuellen Zweck und beschreiben Sie danach Bildausschnitt, Umgebung, Beleuchtung und Medium. Eine hilfreiche Anweisung für ein Produktkonzept lautet: «Ein kompaktes cremefarbenes Radio auf einem Schreibtisch aus Nussbaumholz, vordere Dreiviertelansicht, weiches Fensterlicht, ruhige redaktionelle Fotografie, grosszügiger Freiraum links.» Benennen Sie für eine Illustration die Formensprache, die Palette und die Beziehungen zwischen den Elementen. Halten Sie die Details, die die Idee bestimmen, ausdrücklich fest, statt unzusammenhängende Adjektive hinzuzufügen. Flash erlaubt laut Dokumentation Prompts mit bis zu 10'000 Zeichen, sodass sich eine detaillierte Szene beschreiben lässt, wenn die Aufgabe das erfordert.\n\nZu den Herstellereinstellungen gehören bevorzugte Farben und eine gewünschte Hintergrundfarbe. Ein Seed kann für reproduzierbare Ergebnisse angegeben werden; die Generierungsschnittstelle dokumentiert ein bis sechs Bilder pro Anfrage. Diese Einstellungen ermöglichen eine sinnvolle Vergleichsaufgabe: Motiv und Komposition konstant halten, eine visuelle Richtung variieren und die entstehenden Bilder für das vorgesehene Layout prüfen. Farbwünsche beschreiben das angeforderte Ergebnis; vergleichen Sie wichtige Markenfarben mit dem fertigen Bild, bevor Sie es mit einem bestehenden Designsystem kombinieren.\n\nFlash erzeugt Rastergrafiken. Ein Logokonzept kann helfen, Silhouette, Stimmung oder Anordnung auszuwählen; bearbeitbare Pfade gehören dagegen zu den separat benannten Vector-Modellen. Flash hat zudem keine Pro-Variante. Die vollständige V4.1-Reihe bietet diese gesonderten Optionen, wenn Vektorbearbeitung oder höher auflösende Details für das Ergebnis entscheidend sind. Der Hersteller beschreibt einen späteren Verfeinerungsschritt, der einen gewählten Entwurf zu einem detaillierteren Bild weiterentwickelt; dieser Schritt ist eine eigenständige Operation und keine andere native Flash-Ausgabegrösse.\n\nDiese Ausgabe unterstützt weder Bild-zu-Bild-Eingaben noch benutzerdefinierte Stile, Stilkennungen, Stilabgleich oder Stilreferenzbilder. Ihre dokumentierte Schnittstelle schliesst ausserdem negative Prompts und ausdrückliche Textlayout-Einstellungen aus. Beschreiben Sie das gewünschte Erscheinungsbild und die Komposition im positiven Briefing. Wenn Schrift zu einem Konzept gehört, zitieren Sie den gewünschten Wortlaut und prüfen Sie die gerenderten Buchstaben; nutzen Sie eine separate Layoutphase, wenn exakte Typografie und Platzierung entscheidend sind.\n\nEin praktisches Ergebnis von Flash ist eine ausgewählte visuelle Richtung mit klarem Briefing, passendem Seitenverhältnis und nutzbarer Rasterdatei. Vergleichen Sie Motiv, Bildausschnitt, Hintergrund und wichtige Details in der Grösse, in der das Bild erscheinen wird. Bewahren Sie den erfolgreichen Prompt gemeinsam mit der gewählten Datei auf, damit der nächste kreative Schritt der ausgewählten Richtung folgt. Schnelle Iterationen helfen, das Design zu erkunden; native Vektorausgabe, Stilabgleich anhand von Referenzen und die Auflösung einer anderen V4.1-Ausgabe bleiben getrennte Modellentscheidungen.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "7fe4687197666b2ca1d98f2651a7dee66c72154c97537dde5d5bce6b1e640921", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "de-ch", "methods": [ { "html": "
•

Recraft: Recraft V4.1 Flash

Recraft /recraft/recraft-v4.1-flash

Einstieg

Recraft V4.1 Flash erzeugt Rasterbilder in 1K aus Text für schnelle visuelle Iterationen. Es unterstützt Fotografie, Porträts, komplexe Szenen und Logokonzepte mit PNG- oder verlustfreier WebP-Ausgabe und ausdrücklichen Farbwünschen.

Zulässige Eingaben
Text
Ergebnisse
Bilder
Über das Modell

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.

Recraft V4.1 Flash ist Recrafts Text-zu-Bild-Modell für schnelle Iterationen und visuelle Arbeit mit hohem Volumen. Der Hersteller nennt Fotografie, Porträts, Atmosphäre, komplexe Szenen, Mixed Media und Logokonzepte als starke Einsatzgebiete. Ein schriftliches Briefing wird zu einem Rasterbild, das sich mit anderen kreativen Richtungen vergleichen lässt, bevor ein fertiges Bild ausgearbeitet wird. Flash ist ein bestimmtes Mitglied der V4.1-Familie mit eigener Ausgabegrösse und eigenen unterstützten Einstellungen.

Die native Ausgabe gehört zu Recrafts 1K-Rasterbildklasse. Wählen Sie die Bildfläche passend zum vorgesehenen Einsatz: eine horizontale Illustration für einen Seitenkopf, ein vertikales Porträt oder ein quadratisches Motiv für eine kompakte Karte. Als Ausgabeformate stehen verlustfreies WebP und PNG zur Verfügung.

Beginnen Sie das Briefing mit dem Hauptmotiv und dem visuellen Zweck und beschreiben Sie danach Bildausschnitt, Umgebung, Beleuchtung und Medium. Eine hilfreiche Anweisung für ein Produktkonzept lautet: «Ein kompaktes cremefarbenes Radio auf einem Schreibtisch aus Nussbaumholz, vordere Dreiviertelansicht, weiches Fensterlicht, ruhige redaktionelle Fotografie, grosszügiger Freiraum links.» Benennen Sie für eine Illustration die Formensprache, die Palette und die Beziehungen zwischen den Elementen. Halten Sie die Details, die die Idee bestimmen, ausdrücklich fest, statt unzusammenhängende Adjektive hinzuzufügen. Flash erlaubt laut Dokumentation Prompts mit bis zu 10'000 Zeichen, sodass sich eine detaillierte Szene beschreiben lässt, wenn die Aufgabe das erfordert.

Zu den Herstellereinstellungen gehören bevorzugte Farben und eine gewünschte Hintergrundfarbe. Ein Seed kann für reproduzierbare Ergebnisse angegeben werden; die Generierungsschnittstelle dokumentiert ein bis sechs Bilder pro Anfrage. Diese Einstellungen ermöglichen eine sinnvolle Vergleichsaufgabe: Motiv und Komposition konstant halten, eine visuelle Richtung variieren und die entstehenden Bilder für das vorgesehene Layout prüfen. Farbwünsche beschreiben das angeforderte Ergebnis; vergleichen Sie wichtige Markenfarben mit dem fertigen Bild, bevor Sie es mit einem bestehenden Designsystem kombinieren.

Flash erzeugt Rastergrafiken. Ein Logokonzept kann helfen, Silhouette, Stimmung oder Anordnung auszuwählen; bearbeitbare Pfade gehören dagegen zu den separat benannten Vector-Modellen. Flash hat zudem keine Pro-Variante. Die vollständige V4.1-Reihe bietet diese gesonderten Optionen, wenn Vektorbearbeitung oder höher auflösende Details für das Ergebnis entscheidend sind. Der Hersteller beschreibt einen späteren Verfeinerungsschritt, der einen gewählten Entwurf zu einem detaillierteren Bild weiterentwickelt; dieser Schritt ist eine eigenständige Operation und keine andere native Flash-Ausgabegrösse.

Diese Ausgabe unterstützt weder Bild-zu-Bild-Eingaben noch benutzerdefinierte Stile, Stilkennungen, Stilabgleich oder Stilreferenzbilder. Ihre dokumentierte Schnittstelle schliesst ausserdem negative Prompts und ausdrückliche Textlayout-Einstellungen aus. Beschreiben Sie das gewünschte Erscheinungsbild und die Komposition im positiven Briefing. Wenn Schrift zu einem Konzept gehört, zitieren Sie den gewünschten Wortlaut und prüfen Sie die gerenderten Buchstaben; nutzen Sie eine separate Layoutphase, wenn exakte Typografie und Platzierung entscheidend sind.

Ein praktisches Ergebnis von Flash ist eine ausgewählte visuelle Richtung mit klarem Briefing, passendem Seitenverhältnis und nutzbarer Rasterdatei. Vergleichen Sie Motiv, Bildausschnitt, Hintergrund und wichtige Details in der Grösse, in der das Bild erscheinen wird. Bewahren Sie den erfolgreichen Prompt gemeinsam mit der gewählten Datei auf, damit der nächste kreative Schritt der ausgewählten Richtung folgt. Schnelle Iterationen helfen, das Design zu erkunden; native Vektorausgabe, Stilabgleich anhand von Referenzen und die Auflösung einer anderen V4.1-Ausgabe bleiben getrennte Modellentscheidungen.

In Ailoot verfügbar · Eingaben und Methoden

Ailoot Ultra · Bilder POST /v1/images/generations
Eingabe
text
Ausgabe
image
Ausgabeformat
Bilddatei
Ausgabeanzahl
1 Ausgabe
FeldTypAnforderungWerte und LimitsStandard
FeldmodelTypstringAnforderungErforderlichWerte und Limits
recraft/recraft-v4.1-flash
Standard—
FeldpromptTypstringAnforderungErforderlichWerte und Limits
Mindestlänge: 1
Bedingungen: Nicht leere UTF8-Textbeschreibung. Es wird keine herstellerweite Zeichengrenze erfunden.
Standard—
FeldnTypintegerAnforderungOptionalWerte und Limits
1
Standard1
Feldresponse_formatTypstringAnforderungOptionalWerte und Limits
url, b64_json
Standard—
FeldstreamTypbooleanAnforderungOptionalWerte und Limits
false
Standardfalse
Kombinationen von Eingabematerialien

Text zu Bild · Erforderlich: prompt

Methodenparameter und Lebenszyklus
ParameterVertrag
Parametercontent_typeVertragapplication/json
ParameterrequiredVertragmodel, prompt
Parametermaterial_typesVertragtext
ParameteroptionalVertragn, response_format, stream
ParameternVertrag1
ParameterstreamVertragfalse
Parameterresponse_formatVertragurl, b64_json
Parameterreference_imagesVertragfalse
ParametereditVertragfalse
Parameteroutput_format_optionalVertrag
Parameterresolution_controlVertragnull
Parameteraspect_ratio_controlVertragnull
Parameterother_fieldsVertragAbgewiesen, ausser bei exakt festgelegtem internem Anbieterrouting

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}

Erzeugen Sie ein Bild aus einer Textbeschreibung.

Speichern Sie jedes Datenelement; url/b64_json sind Ergebnisdarstellungen.

Tarife

So wird die endgültige Gebühr berechnet

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.

Schnellmodus
Nicht angegeben Wenn der Schnellmodus ausgewählt ist
Flex-Modus
Nicht angegeben Wenn der Modus flex ausgewählt ist
Maximaler Denkaufwand
Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird

Geschätzte Tarife zum Vergleich

Preise nach Konfiguration

Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.

KonfigurationTarifstaffelPrognostizierte MengeAbrechnungseinheitGebühr
KonfigurationToken-BasistarifeTarifstaffelGrundtarifPrognostizierte 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
KonfigurationUltraTarifstaffel—Prognostizierte Menge—Abrechnungseinheitpro AusgabebildGebühr
Ausgabe · Bildausgabe · Schätzung nur zum Vergleich $0.014 pro Ausgabebild
KonfigurationGeschätzte ErzeugungskostenTarifstaffel—Prognostizierte MengeSchätzung für eine GenerierungAbrechnungseinheit—Gebühr
Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.014 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 →

Details zum Referenztarif

Referenztarifstaffeln auf Modellebene ändern weder Methodenauswahl noch Kostenvoranschläge oder Gebühren. Für die aktive Abrechnung gelten die Tarife der ausgewählten Ailoot-Methode.

Preiskonfigurationen für Bilder

Preise nach Konfiguration

KonfigurationAbrechnungsbedingungenGebühr
KonfigurationAusgabebildAbrechnungsbedingungenEs ist keine Preisvariante deklariert.Gebühr
Ausgabe · Ausgabebild $0.014 pro Bild

Gleichwertige Einträge beschreiben dieselbe Abbuchung; sie verursachen keine zweite Gebühr.

Beispielanfragen

Ailoot Ultra · Bilder

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=json.loads('{"model": "recraft/recraft-v4.1-flash", "prompt": "A lighthouse on a cliff, watercolor", "n": 1, "response_format": "b64_json"}')\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\n

Ergebnisse abrufen und speichern

Ailoot Ultra · Bilder

Laden Sie jedes zurückgegebene Bild herunter oder speichern Sie seinen Base64-Inhalt

Alle fertiggestellten Ergebnisse aufbewahren

Speichern Sie jedes fertiggestellte Bild; rufen Sie jede zurückgegebene URL ab oder dekodieren Sie seinen Base64-Inhalt.

Jedes Datenelement speichern. Jedes b64_json dekodieren oder jede zurückgegebene signierte URL abrufen. Die Dateiendung anhand des tatsächlichen MIME-Typs bzw. der Bytes wählen.

Wenn die ursprüngliche Antwort geprüft werden muss

Wenn das Ergebnis einer Bildgenerierung oder -bearbeitung geprüft werden muss, die ursprüngliche operation_id/X-Client-Request-ID und die zurückgegebenen Ergebnisinformationen aufbewahren. Bereits vorhandene eigene Ergebnisse über die Medienbibliothek anhand tatsächlicher task_id- oder asset_id-Werte wiederherstellen. Die Generierungs-/Bearbeitungsanfrage nicht erneut senden und keine Abfrage-URL aus operation_id bilden.

Antwortfelder
FeldTyp
FeldcreatedTypinteger
Felddata[].urlTypstring
Felddata[].b64_jsonTypbase64 string
FeldusageTypobject
Fehler und nächste Schritte
AntwortBedingungNächster Schritt
Antwort400 · invalid_request_errorBedingungPflichtfelder, Darstellung des Eingabematerials oder Parameterwert ungültigNächster SchrittDie angegebenen Felder vor einer neuen Erstellungsanfrage korrigieren.
Antwortserver_errorBedingungDie zurückgegebene Antwort gibt an, dass der Vorgang oder das Ergebnis eine Prüfung erfordertNächster SchrittDie ursprünglich zurückgegebene Vorgangs-/Aufgaben-ID, die Anfrageheader und die Antwort aufbewahren; mit unterstützten Leseaufrufen für diesen ursprünglichen Vorgang fortfahren. Die Erstellungsanfrage nicht erneut senden.

Aliasnamen

Modellaliasnamen

Ailoot Ultra recraft/recraft-v4.1-flash

Aliasnamen für Methodenpfade

Verwenden Sie die oben angezeigten Methodenpfade.

Zugehörige Aufrufer-IDs

recraft/recraft-v4.1-flash

", "method_identity": { "effective_request_model_id": "recraft/recraft-v4.1-flash", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "recraft/recraft-v4.1-flash", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|recraft%2Frecraft-v4.1-flash", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "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.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Save every data item. Decode each b64_json or fetch every returned signed URL. Select a filename extension from the actual MIME/bytes.", "errors": [ { "code": null, "condition": "Pflichtfelder, Darstellung des Eingabematerials oder Parameterwert ungültig", "http_status": 400, "recovery": "Die angegebenen Felder vor einer neuen Erstellungsanfrage korrigieren.", "type": "invalid_request_error" }, { "code": null, "condition": "Die zurückgegebene Antwort gibt an, dass der Vorgang oder das Ergebnis eine Prüfung erfordert", "http_status": null, "recovery": "Die ursprünglich zurückgegebene Vorgangs-/Aufgaben-ID, die Anfrageheader und die Antwort aufbewahren; mit unterstützten Leseaufrufen für diesen ursprünglichen Vorgang fortfahren. Die Erstellungsanfrage nicht erneut senden.", "type": "server_error" } ], "hints": [], "ignored_fields": [], "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Wenn das Ergebnis einer Bildgenerierung oder -bearbeitung geprüft werden muss, die ursprüngliche operation_id/X-Client-Request-ID und die zurückgegebenen Ergebnisinformationen aufbewahren. Bereits vorhandene eigene Ergebnisse über die Medienbibliothek anhand tatsächlicher task_id- oder asset_id-Werte wiederherstellen. Die Generierungs-/Bearbeitungsanfrage nicht erneut senden und keine Abfrage-URL aus operation_id bilden." }, "material_combinations": [ { "content_type": "application/json", "mode": "text_to_image", "reference_images": false, "required": [ "prompt" ] } ], "media_library": { "asset": { "fields": [ { "description": null, "name": "asset_id", "type": "string" }, { "description": null, "name": "task_id", "type": "string" }, { "description": null, "name": "output_key", "type": "string" }, { "description": null, "name": "family", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "method", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "content_type", "type": "string" }, { "description": null, "name": "sha256", "type": "string" }, { "description": null, "name": "size_bytes", "type": "integer" }, { "description": null, "name": "content_url", "type": "string" } ], "http": "GET", "id_source": "actual returned asset_id", "path": "/v1/media/assets/{asset_id}" }, "content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "range_header_supported": true, "url_source": "Use exact returned signed content_url including its token; do not construct a token." }, "expired_link": { "code": "link_expired", "http_status": 404, "recovery": "Read the asset again to obtain its refreshed signed content_url, then fetch that URL. Do not regenerate." }, "list": { "all_pages": "Follow every returned next_cursor, then select records by their actual task_id/output_key.", "http": "GET", "output_fields": [ { "description": null, "name": "object", "type": "string" }, { "description": null, "name": "data", "type": "asset[]" }, { "description": null, "name": "next_cursor", "type": "string|null" } ], "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "family", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "cursor", "required": false, "type": "string" }, { "availability": "source_interface", "default": 20, "default_known": true, "enum": null, "enum_known": false, "maximum": 100, "minimum": 1, "name": "limit", "required": false, "type": "integer" } ], "path": "/v1/media/assets" }, "revoke": { "http": "DELETE", "meaning": "Revokes/deletes the existing owned file; this is not generation cancellation.", "path": "/v1/media/assets/{asset_id}", "pending_status": "revoking", "success_statuses": [ 202, 204 ] }, "task": { "http": "GET", "id_source": "actual returned task_id or media library record; operation_id is not task_id", "path": "/v1/media/tasks/{task_id}" } }, "operation_modes": [ "text_to_image" ], "outputs": { "all_results": "Jedes Datenelement speichern. Jedes b64_json dekodieren oder jede zurückgegebene signierte URL abrufen. Die Dateiendung anhand des tatsächlichen MIME-Typs bzw. der Bytes wählen.", "count": 1, "family": "image", "fields": [ { "description": null, "name": "created", "type": "integer" }, { "description": null, "name": "data[].url", "type": "string" }, { "description": null, "name": "data[].b64_json", "type": "base64 string" }, { "description": null, "name": "usage", "type": "object" } ], "format": "actual validated raster MIME" }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "recraft/recraft-v4.1-flash" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "conditions": "Nicht leere UTF8-Textbeschreibung. Es wird keine herstellerweite Zeichengrenze erfunden.", "default": null, "default_known": false, "enum": null, "enum_known": false, "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "availability": "source_interface", "default": 1, "default_known": true, "enum": [ 1 ], "enum_known": true, "name": "n", "required": false, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "url", "b64_json" ], "enum_known": true, "name": "response_format", "required": false, "type": "string" }, { "availability": "source_interface", "default": false, "default_known": true, "enum": [ false ], "enum_known": true, "name": "stream", "required": false, "type": "boolean" } ], "profile_binding": "Exact existing Ailoot model and method; interface constraints below do not assert provider qualification.", "unsupported": [ "image edits/references", "resolution/size", "aspect_ratio", "stream=true", "n other than1", "other fields outside this exact facade profile", "output_format field must be omitted" ] }, "hints": [ "Erzeugen Sie ein Bild aus einer Textbeschreibung.", "Speichern Sie jedes Datenelement; url/b64_json sind Ergebnisdarstellungen." ], "input": { "aspect_ratio_control": null, "content_type": "application/json", "edit": false, "material_types": [ "text" ], "n": [ 1 ], "optional": [ "n", "response_format", "stream" ], "other_fields": "Abgewiesen, ausser bei exakt festgelegtem internem Anbieterrouting", "output_format_optional": [], "reference_images": false, "required": [ "model", "prompt" ], "resolution_control": null, "response_format": [ "url", "b64_json" ], "stream": [ false ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "die tatsächlich zurückgegebene task_id oder ein Eintrag in der Medienbibliothek", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "If an image generation or edit result requires a check, keep the original operation_id/X-Client-Request-ID and returned result information. Recover existing owned results through the media library using actual task_id or asset_id values. Do not resubmit the generation/edit request or construct a polling URL from operation_id." }, "manufacturer_capability": null, "method": { "http": "POST", "path": "/v1/images/generations" }, "method_aliases": [], "operation_modes": [ "text_to_image" ], "output": { "count": 1, "family": "image", "format": "validated raster MIME", "result": "actual owned URL or b64_json" } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quoted_unit": "per image output" }, "label": "Ultra", "units": [ { "amount": "0.014", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "image output", "native_amount_usd_per_unit": "0.014", "native_quantity": 1, "public_unit_label": "per image output", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Geschätzte Erzeugungskosten", "units": [ { "amount": "0.014", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.014", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "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=json.loads('{\"model\": \"recraft/recraft-v4.1-flash\", \"prompt\": \"A lighthouse on a cliff, watercolor\", \"n\": 1, \"response_format\": \"b64_json\"}')\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\"