Recraft V4.1 Utility Pro ist die höher auflösende Rastervariante des Utility-Zweigs innerhalb von Recraft V4.1. Der Hersteller unterscheidet Utilitys geradlinige Darstellung von den ausdrucksstärkeren Perspektiv-, Licht- und Kompositionsentscheidungen des Hauptmodells V4.1. Utility bevorzugt einfache Szenen, gleichmäßige Beleuchtung und frontal dargestellte Motive. Es eignet sich daher für Produktangebotsbilder, Mockups und andere Aufgaben, bei denen das Objekt leicht erfassbar sein soll und eine ruhige Komposition der Aufgabe dient.
Der genaue Modellcode lautet recraftv4_1_utility_pro. Die Herstellerreferenz nennt 2K-Rasterausgaben mit feineren Details als verlustfreies WebP oder PNG. Die Größentabelle gibt 2048 × 2048 Pixel für quadratische Bilder und 2432 × 1792 für 4:3 an. Andere unterstützte Seitenverhältnisse verwenden eigene Abmessungen. Das unterscheidet Utility Pro von der 1K-Ausgabe von Standard-Utility. Das Bild wird dadurch nicht zu einer bearbeitbaren Vektordatei; dafür liefert eine Vector-Ausgabe SVG.
Beginnen Sie mit einem Briefing, das Objekt, Material, Blickwinkel, Hintergrund und die wenigen unbedingt sichtbaren Details benennt. Fordern Sie für eine Produktanzeige ein frontal aufgenommenes Keramik-Vorratsglas auf einer hellen neutralen Fläche an, mit gleichmäßiger Beleuchtung, geschlossenem Deckel und klarem Freiraum um die Silhouette. Wenn die Szene geradlinig bleiben muss, sagen Sie dies ausdrücklich, statt sich darauf zu verlassen, dass der Name Utility alle Darstellungsentscheidungen umfasst. Halten Sie für eine Serie von Angebotsbildern die Anforderungen an Bildausschnitt und Hintergrund konsistent und ändern Sie die Produktbeschreibung.
Die V4.1-Generierungsreferenz unterstützt Prompts mit bis zu 10.000 Zeichen, Vorgaben für bevorzugte Farben und die Hintergrundfarbe, einen Zufalls-Seed und ein bis sechs Ausgaben. Ein kompatibler gespeicherter Stil oder optionale Referenzbilder können das Erscheinungsbild leiten. Die eigenständige V4-Styles-Familie ist die separate Reihe, bei der ein Stil immer verpflichtend ist. Verwenden Sie für optionale Referenzen klare Bilder mit übereinstimmender visueller Richtung. Eine exakte Farbwiedergabe der Referenz ist nicht garantiert. Eine Markenfarbanforderung benötigt deshalb weiterhin ein ausdrückliches Briefing und eine Prüfung der Ausgabe. Verwenden Sie für die Generierung mit Stilreferenzen ein bis zehn PNG-, JPG- oder WebP-Bilder, insgesamt höchstens 64 MB und jeweils unter 20 MB. Bei jeder Referenz muss die kürzeste Seite mindestens 256 Pixel, die längste höchstens 4.096 Pixel messen; die Auflösung darf höchstens 16 Megapixel betragen. Verwenden Sie entweder diese Referenzen oder einen kompatiblen gespeicherten Stil, nicht beides. Bei der Generierung mit Stilreferenzen erlaubt der flexible Abgleich eine freiere Interpretation, während der präzise Abgleich Darstellung, Palette, Komposition und Beleuchtung enger folgt.
Recraft dokumentiert auch Image-to-Image für die V4.1-Reihe: Ein vorhandenes Bild wird mit einem Prompt und einer Stärke von 0 bis 1 kombiniert. Eine geringere Stärke bleibt näher an der Vorlage, eine höhere erlaubt stärkere Veränderungen. Das ist nützlich, wenn die Ausgangskomposition oder das Motiv eine neue Version prägen soll. Benutzerdefinierte V4.1-Stilsteuerungen werden in derselben Transformationsoperation nicht akzeptiert. Die Bildeingabegrenzen des Herstellers sind unter 20 MB, bis zu 16 MP und Seitenlängen zwischen 256 und 4096 Pixeln.
Utility Pro teilt die V4.1-Beschränkungen für negative_prompt, kuratierte Stilnamen, text_layout, artistic_level und no_text. Beschreiben Sie die beabsichtigte Szene positiv und sehen Sie bei Bedarf einen geeigneten Abschlussschritt für präzise Schrift- oder Layoutarbeit vor. Prüfen Sie ein Produktbild auf das angegebene Material, die Form und die erforderlichen Details, bevor Sie es als originalgetreues Angebotsmotiv verwenden. Das nützliche Ergebnis ist eine größere Rasterkomposition für ein klares Produkt- oder Mockup-Briefing. Die exakten Produktfakten bleiben dabei jene, die in der Aufgabe vorgegeben wurden.
", "aboutText": "Recraft V4.1 Utility Pro ist die höher auflösende Rastervariante des Utility-Zweigs innerhalb von Recraft V4.1. Der Hersteller unterscheidet Utilitys geradlinige Darstellung von den ausdrucksstärkeren Perspektiv-, Licht- und Kompositionsentscheidungen des Hauptmodells V4.1. Utility bevorzugt einfache Szenen, gleichmäßige Beleuchtung und frontal dargestellte Motive. Es eignet sich daher für Produktangebotsbilder, Mockups und andere Aufgaben, bei denen das Objekt leicht erfassbar sein soll und eine ruhige Komposition der Aufgabe dient.\n\nDer genaue Modellcode lautet recraftv4_1_utility_pro. Die Herstellerreferenz nennt 2K-Rasterausgaben mit feineren Details als verlustfreies WebP oder PNG. Die Größentabelle gibt 2048 × 2048 Pixel für quadratische Bilder und 2432 × 1792 für 4:3 an. Andere unterstützte Seitenverhältnisse verwenden eigene Abmessungen. Das unterscheidet Utility Pro von der 1K-Ausgabe von Standard-Utility. Das Bild wird dadurch nicht zu einer bearbeitbaren Vektordatei; dafür liefert eine Vector-Ausgabe SVG.\n\nBeginnen Sie mit einem Briefing, das Objekt, Material, Blickwinkel, Hintergrund und die wenigen unbedingt sichtbaren Details benennt. Fordern Sie für eine Produktanzeige ein frontal aufgenommenes Keramik-Vorratsglas auf einer hellen neutralen Fläche an, mit gleichmäßiger Beleuchtung, geschlossenem Deckel und klarem Freiraum um die Silhouette. Wenn die Szene geradlinig bleiben muss, sagen Sie dies ausdrücklich, statt sich darauf zu verlassen, dass der Name Utility alle Darstellungsentscheidungen umfasst. Halten Sie für eine Serie von Angebotsbildern die Anforderungen an Bildausschnitt und Hintergrund konsistent und ändern Sie die Produktbeschreibung.\n\nDie V4.1-Generierungsreferenz unterstützt Prompts mit bis zu 10.000 Zeichen, Vorgaben für bevorzugte Farben und die Hintergrundfarbe, einen Zufalls-Seed und ein bis sechs Ausgaben. Ein kompatibler gespeicherter Stil oder optionale Referenzbilder können das Erscheinungsbild leiten. Die eigenständige V4-Styles-Familie ist die separate Reihe, bei der ein Stil immer verpflichtend ist. Verwenden Sie für optionale Referenzen klare Bilder mit übereinstimmender visueller Richtung. Eine exakte Farbwiedergabe der Referenz ist nicht garantiert. Eine Markenfarbanforderung benötigt deshalb weiterhin ein ausdrückliches Briefing und eine Prüfung der Ausgabe. Verwenden Sie für die Generierung mit Stilreferenzen ein bis zehn PNG-, JPG- oder WebP-Bilder, insgesamt höchstens 64 MB und jeweils unter 20 MB. Bei jeder Referenz muss die kürzeste Seite mindestens 256 Pixel, die längste höchstens 4.096 Pixel messen; die Auflösung darf höchstens 16 Megapixel betragen. Verwenden Sie entweder diese Referenzen oder einen kompatiblen gespeicherten Stil, nicht beides. Bei der Generierung mit Stilreferenzen erlaubt der flexible Abgleich eine freiere Interpretation, während der präzise Abgleich Darstellung, Palette, Komposition und Beleuchtung enger folgt.\n\nRecraft dokumentiert auch Image-to-Image für die V4.1-Reihe: Ein vorhandenes Bild wird mit einem Prompt und einer Stärke von 0 bis 1 kombiniert. Eine geringere Stärke bleibt näher an der Vorlage, eine höhere erlaubt stärkere Veränderungen. Das ist nützlich, wenn die Ausgangskomposition oder das Motiv eine neue Version prägen soll. Benutzerdefinierte V4.1-Stilsteuerungen werden in derselben Transformationsoperation nicht akzeptiert. Die Bildeingabegrenzen des Herstellers sind unter 20 MB, bis zu 16 MP und Seitenlängen zwischen 256 und 4096 Pixeln.\n\nUtility Pro teilt die V4.1-Beschränkungen für negative_prompt, kuratierte Stilnamen, text_layout, artistic_level und no_text. Beschreiben Sie die beabsichtigte Szene positiv und sehen Sie bei Bedarf einen geeigneten Abschlussschritt für präzise Schrift- oder Layoutarbeit vor. Prüfen Sie ein Produktbild auf das angegebene Material, die Form und die erforderlichen Details, bevor Sie es als originalgetreues Angebotsmotiv verwenden. Das nützliche Ergebnis ist eine größere Rasterkomposition für ein klares Produkt- oder Mockup-Briefing. Die exakten Produktfakten bleiben dabei jene, die in der Aufgabe vorgegeben wurden.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "be6726237669f5da6b322c19caea84adc8d84c3c21658efc968b49f7b0e878ba", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "de", "methods": [ { "html": "recraft/recraft-v4.1-utility-proRecraft V4.1 Utility Pro erzeugt 2K-Rasterbilder mit Schwerpunkt auf einfachen, vorhersehbaren Szenen, gleichmäßiger Beleuchtung und frontaler Komposition. Es eignet sich für detaillierte Produktaufnahmen und Mockups, die eine klare Darstellung statt einer ausdrucksstarken Art Direction benötigen.
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 Utility Pro ist die höher auflösende Rastervariante des Utility-Zweigs innerhalb von Recraft V4.1. Der Hersteller unterscheidet Utilitys geradlinige Darstellung von den ausdrucksstärkeren Perspektiv-, Licht- und Kompositionsentscheidungen des Hauptmodells V4.1. Utility bevorzugt einfache Szenen, gleichmäßige Beleuchtung und frontal dargestellte Motive. Es eignet sich daher für Produktangebotsbilder, Mockups und andere Aufgaben, bei denen das Objekt leicht erfassbar sein soll und eine ruhige Komposition der Aufgabe dient.
Der genaue Modellcode lautet recraftv4_1_utility_pro. Die Herstellerreferenz nennt 2K-Rasterausgaben mit feineren Details als verlustfreies WebP oder PNG. Die Größentabelle gibt 2048 × 2048 Pixel für quadratische Bilder und 2432 × 1792 für 4:3 an. Andere unterstützte Seitenverhältnisse verwenden eigene Abmessungen. Das unterscheidet Utility Pro von der 1K-Ausgabe von Standard-Utility. Das Bild wird dadurch nicht zu einer bearbeitbaren Vektordatei; dafür liefert eine Vector-Ausgabe SVG.
Beginnen Sie mit einem Briefing, das Objekt, Material, Blickwinkel, Hintergrund und die wenigen unbedingt sichtbaren Details benennt. Fordern Sie für eine Produktanzeige ein frontal aufgenommenes Keramik-Vorratsglas auf einer hellen neutralen Fläche an, mit gleichmäßiger Beleuchtung, geschlossenem Deckel und klarem Freiraum um die Silhouette. Wenn die Szene geradlinig bleiben muss, sagen Sie dies ausdrücklich, statt sich darauf zu verlassen, dass der Name Utility alle Darstellungsentscheidungen umfasst. Halten Sie für eine Serie von Angebotsbildern die Anforderungen an Bildausschnitt und Hintergrund konsistent und ändern Sie die Produktbeschreibung.
Die V4.1-Generierungsreferenz unterstützt Prompts mit bis zu 10.000 Zeichen, Vorgaben für bevorzugte Farben und die Hintergrundfarbe, einen Zufalls-Seed und ein bis sechs Ausgaben. Ein kompatibler gespeicherter Stil oder optionale Referenzbilder können das Erscheinungsbild leiten. Die eigenständige V4-Styles-Familie ist die separate Reihe, bei der ein Stil immer verpflichtend ist. Verwenden Sie für optionale Referenzen klare Bilder mit übereinstimmender visueller Richtung. Eine exakte Farbwiedergabe der Referenz ist nicht garantiert. Eine Markenfarbanforderung benötigt deshalb weiterhin ein ausdrückliches Briefing und eine Prüfung der Ausgabe. Verwenden Sie für die Generierung mit Stilreferenzen ein bis zehn PNG-, JPG- oder WebP-Bilder, insgesamt höchstens 64 MB und jeweils unter 20 MB. Bei jeder Referenz muss die kürzeste Seite mindestens 256 Pixel, die längste höchstens 4.096 Pixel messen; die Auflösung darf höchstens 16 Megapixel betragen. Verwenden Sie entweder diese Referenzen oder einen kompatiblen gespeicherten Stil, nicht beides. Bei der Generierung mit Stilreferenzen erlaubt der flexible Abgleich eine freiere Interpretation, während der präzise Abgleich Darstellung, Palette, Komposition und Beleuchtung enger folgt.
Recraft dokumentiert auch Image-to-Image für die V4.1-Reihe: Ein vorhandenes Bild wird mit einem Prompt und einer Stärke von 0 bis 1 kombiniert. Eine geringere Stärke bleibt näher an der Vorlage, eine höhere erlaubt stärkere Veränderungen. Das ist nützlich, wenn die Ausgangskomposition oder das Motiv eine neue Version prägen soll. Benutzerdefinierte V4.1-Stilsteuerungen werden in derselben Transformationsoperation nicht akzeptiert. Die Bildeingabegrenzen des Herstellers sind unter 20 MB, bis zu 16 MP und Seitenlängen zwischen 256 und 4096 Pixeln.
Utility Pro teilt die V4.1-Beschränkungen für negative_prompt, kuratierte Stilnamen, text_layout, artistic_level und no_text. Beschreiben Sie die beabsichtigte Szene positiv und sehen Sie bei Bedarf einen geeigneten Abschlussschritt für präzise Schrift- oder Layoutarbeit vor. Prüfen Sie ein Produktbild auf das angegebene Material, die Form und die erforderlichen Details, bevor Sie es als originalgetreues Angebotsmotiv verwenden. Das nützliche Ergebnis ist eine größere Rasterkomposition für ein klares Produkt- oder Mockup-Briefing. Die exakten Produktfakten bleiben dabei jene, die in der Aufgabe vorgegeben wurden.
POST /v1/images/generationstext, imageimage| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits recraft/recraft-v4.1-utility-pro | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits Mindestlänge: 1 | Standard— |
Feldaspect_ratio | Typstring | AnforderungOptional | Werte und Limits 1:1, 4:3, 3:4, 16:9, 9:16, auto | Standard— |
Feldn | Typinteger | AnforderungOptional | Werte und Limits Minimum: 1 Maximum: 6 | Standard— |
Feldinput_references | Typarray | AnforderungOptional | Werte und Limits Mindestanzahl Elemente: 0 Maximale Anzahl Elemente: 1 | 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 |
|---|---|---|---|---|
| KonfigurationBasistarife für Token | TarifstaffelGrundtarif | Prognostizierte Menge— | Abrechnungseinheit— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Token Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Lesen · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Token |
| KonfigurationAusgabebild | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Ausgabebild | Gebühr Ausgabe · Ausgabebild · Schätzung nur zum Vergleich $0.42 pro Ausgabebild |
| KonfigurationGeschätzte Generierungskosten | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Abrechnungseinheit— | Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.42 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 abschließenden 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': 'recraft/recraft-v4.1-utility-pro', '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 recraft/recraft-v4.1-utility-pro
/v1/images