Recraft V4.1 Utility ist das standardmässige Rastermodell Utility der V4.1-Familie von Recraft. Es bevorzugt einfache Szenen, gleichmässige Beleuchtung und frontale Kompositionen gegenüber der ausdrucksstärkeren Wahl von Blickwinkel, Licht und Stimmung beim Hauptmodell V4.1. Sein praktischer Einsatzbereich sind klare Produktaufnahmen oder Mockups, bei denen das Objekt und die erforderlichen Details im Vordergrund stehen. Die konkrete Utility-Ausgabe ist von Utility Pro, dem Hauptmodell V4.1 und den Vektorvarianten mit SVG-Ausgabe zu unterscheiden.
Der Modellcode des Herstellers lautet recraftv4_1_utility. Es liefert Rasterbilder in 1K als verlustfreies WebP oder PNG; die Grössen richten sich nach den unterstützten Seitenverhältnissen. Ein quadratisches Bild hat 1024 × 1024 Pixel, ein Bild im Format 4:3 hat 1216 × 896 Pixel. Die Ausgabe Pro Utility verwendet grössere 2K-Abmessungen; diese Ausgabegrössen dürfen daher nicht dem standardmässigen Utility zugeordnet werden. Wählen Sie das Format des vorgesehenen Angebots oder Mockups, bevor Sie die Szene beschreiben.
Ein nützliches Briefing benennt Produkt, Blickwinkel, Material, Untergrund, Hintergrund und Beleuchtung in einfachen Worten. Fordern Sie für ein Produktangebot eine frontal gezeigte Isolierflasche vor einem hellen Hintergrund an, gleichmässig beleuchtet, mit vollständig sichtbarer Silhouette und ohne ablenkende Szenenelemente. Wenn ein Produkt tatsächliche Abmessungen oder charakteristische Bestandteile hat, geben Sie diese Angaben ausdrücklich an. Utilitys Vorliebe für eine unkomplizierte Darstellung begründet keine Tatsachen über ein reales Produkt, die im Briefing fehlen.
Die Generierung unterstützt Prompts mit bis zu 10'000 Zeichen, Einstellungen für bevorzugte Farben und Hintergrundfarbe, einen Zufalls-Seed und ein bis sechs Ausgaben. Optionale kompatible benutzerdefinierte Stile oder Referenzbilder können die Bildsprache eines Katalogs vorgeben. Nutzen Sie Referenzmaterial mit übereinstimmender Beleuchtung und Darstellung und behalten Sie denselben kompatiblen Stil für weitere Produktbriefings bei. Eine exakte Farbübereinstimmung zwischen Referenz und Ausgabe ist nicht garantiert; vergleichen Sie das fertige Bild deshalb mit der geforderten Palette. Für die Generierung anhand von Stilreferenzen verwenden Sie 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 und die Auflösung höchstens 16 Megapixel betragen. Verwenden Sie entweder diese Referenzen oder einen kompatiblen gespeicherten Stil, nicht beides zusammen. Bei der Generierung anhand von Stilreferenzen erlaubt der flexible Abgleich eine freiere Interpretation, während der präzise Abgleich Darstellung, Palette, Komposition und Beleuchtung enger folgt.
Der separate Bild-zu-Bild-Ablauf nutzt ein vorhandenes Bild und einen Prompt; eine Stärke von 0 bis 1 steuert den Umfang der Änderung. Eine geringere Stärke hält das Ergebnis näher an der Vorlage, eine höhere lässt stärkere Abweichungen zu. Als Eingabe sind PNG, JPG, WebP oder SVG unter 20 MB mit bis zu 16 MP und Seitenlängen zwischen 256 und 4096 Pixeln möglich. Benutzerdefinierte V4.1-Stile werden bei dieser Transformation nicht akzeptiert; sie ist vom Anhängen einer Stilreferenz an eine neue Generierung zu unterscheiden.
V4.1 Utility akzeptiert keine kuratierten Stilnamen und keine Einstellungen negative_prompt, text_layout, artistic_level oder no_text. Beschreiben Sie die gewünschte fertige Szene direkt im positiven Prompt. Halten Sie bei einer Serie von Produktbildern die Vorgaben für Bildausschnitt und Hintergrund konstant und vergleichen Sie jedes Bild mit der angegebenen Produktform, dem Material und den Details, bevor Sie es in einem Layout verwenden. Das standardmässige Utility ist ein gezieltes Rasterwerkzeug für eine zurückhaltende Darstellung; wählen Sie Ausgabeformat und Ausgabe passend zur Aufgabe.
", "aboutText": "Recraft V4.1 Utility ist das standardmässige Rastermodell Utility der V4.1-Familie von Recraft. Es bevorzugt einfache Szenen, gleichmässige Beleuchtung und frontale Kompositionen gegenüber der ausdrucksstärkeren Wahl von Blickwinkel, Licht und Stimmung beim Hauptmodell V4.1. Sein praktischer Einsatzbereich sind klare Produktaufnahmen oder Mockups, bei denen das Objekt und die erforderlichen Details im Vordergrund stehen. Die konkrete Utility-Ausgabe ist von Utility Pro, dem Hauptmodell V4.1 und den Vektorvarianten mit SVG-Ausgabe zu unterscheiden.\n\nDer Modellcode des Herstellers lautet recraftv4_1_utility. Es liefert Rasterbilder in 1K als verlustfreies WebP oder PNG; die Grössen richten sich nach den unterstützten Seitenverhältnissen. Ein quadratisches Bild hat 1024 × 1024 Pixel, ein Bild im Format 4:3 hat 1216 × 896 Pixel. Die Ausgabe Pro Utility verwendet grössere 2K-Abmessungen; diese Ausgabegrössen dürfen daher nicht dem standardmässigen Utility zugeordnet werden. Wählen Sie das Format des vorgesehenen Angebots oder Mockups, bevor Sie die Szene beschreiben.\n\nEin nützliches Briefing benennt Produkt, Blickwinkel, Material, Untergrund, Hintergrund und Beleuchtung in einfachen Worten. Fordern Sie für ein Produktangebot eine frontal gezeigte Isolierflasche vor einem hellen Hintergrund an, gleichmässig beleuchtet, mit vollständig sichtbarer Silhouette und ohne ablenkende Szenenelemente. Wenn ein Produkt tatsächliche Abmessungen oder charakteristische Bestandteile hat, geben Sie diese Angaben ausdrücklich an. Utilitys Vorliebe für eine unkomplizierte Darstellung begründet keine Tatsachen über ein reales Produkt, die im Briefing fehlen.\n\nDie Generierung unterstützt Prompts mit bis zu 10'000 Zeichen, Einstellungen für bevorzugte Farben und Hintergrundfarbe, einen Zufalls-Seed und ein bis sechs Ausgaben. Optionale kompatible benutzerdefinierte Stile oder Referenzbilder können die Bildsprache eines Katalogs vorgeben. Nutzen Sie Referenzmaterial mit übereinstimmender Beleuchtung und Darstellung und behalten Sie denselben kompatiblen Stil für weitere Produktbriefings bei. Eine exakte Farbübereinstimmung zwischen Referenz und Ausgabe ist nicht garantiert; vergleichen Sie das fertige Bild deshalb mit der geforderten Palette. Für die Generierung anhand von Stilreferenzen verwenden Sie 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 und die Auflösung höchstens 16 Megapixel betragen. Verwenden Sie entweder diese Referenzen oder einen kompatiblen gespeicherten Stil, nicht beides zusammen. Bei der Generierung anhand von Stilreferenzen erlaubt der flexible Abgleich eine freiere Interpretation, während der präzise Abgleich Darstellung, Palette, Komposition und Beleuchtung enger folgt.\n\nDer separate Bild-zu-Bild-Ablauf nutzt ein vorhandenes Bild und einen Prompt; eine Stärke von 0 bis 1 steuert den Umfang der Änderung. Eine geringere Stärke hält das Ergebnis näher an der Vorlage, eine höhere lässt stärkere Abweichungen zu. Als Eingabe sind PNG, JPG, WebP oder SVG unter 20 MB mit bis zu 16 MP und Seitenlängen zwischen 256 und 4096 Pixeln möglich. Benutzerdefinierte V4.1-Stile werden bei dieser Transformation nicht akzeptiert; sie ist vom Anhängen einer Stilreferenz an eine neue Generierung zu unterscheiden.\n\nV4.1 Utility akzeptiert keine kuratierten Stilnamen und keine Einstellungen negative_prompt, text_layout, artistic_level oder no_text. Beschreiben Sie die gewünschte fertige Szene direkt im positiven Prompt. Halten Sie bei einer Serie von Produktbildern die Vorgaben für Bildausschnitt und Hintergrund konstant und vergleichen Sie jedes Bild mit der angegebenen Produktform, dem Material und den Details, bevor Sie es in einem Layout verwenden. Das standardmässige Utility ist ein gezieltes Rasterwerkzeug für eine zurückhaltende Darstellung; wählen Sie Ausgabeformat und Ausgabe passend zur Aufgabe.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "1d1fe016ff9f2cb22f77b6875879ca60ef3087820f57450d0acafba41b24f910", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "de-ch", "methods": [ { "html": "recraft/recraft-v4.1-utilityRecraft V4.1 Utility erzeugt Rasterbilder in 1K für unkomplizierte Produktaufnahmen, Mockups und einfache Szenen. Es bevorzugt gleichmässige Beleuchtung und frontale Kompositionen; Textprompts sowie optionale Bild- oder Stileingaben geben eine vorhersehbare visuelle Richtung vor.
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 ist das standardmässige Rastermodell Utility der V4.1-Familie von Recraft. Es bevorzugt einfache Szenen, gleichmässige Beleuchtung und frontale Kompositionen gegenüber der ausdrucksstärkeren Wahl von Blickwinkel, Licht und Stimmung beim Hauptmodell V4.1. Sein praktischer Einsatzbereich sind klare Produktaufnahmen oder Mockups, bei denen das Objekt und die erforderlichen Details im Vordergrund stehen. Die konkrete Utility-Ausgabe ist von Utility Pro, dem Hauptmodell V4.1 und den Vektorvarianten mit SVG-Ausgabe zu unterscheiden.
Der Modellcode des Herstellers lautet recraftv4_1_utility. Es liefert Rasterbilder in 1K als verlustfreies WebP oder PNG; die Grössen richten sich nach den unterstützten Seitenverhältnissen. Ein quadratisches Bild hat 1024 × 1024 Pixel, ein Bild im Format 4:3 hat 1216 × 896 Pixel. Die Ausgabe Pro Utility verwendet grössere 2K-Abmessungen; diese Ausgabegrössen dürfen daher nicht dem standardmässigen Utility zugeordnet werden. Wählen Sie das Format des vorgesehenen Angebots oder Mockups, bevor Sie die Szene beschreiben.
Ein nützliches Briefing benennt Produkt, Blickwinkel, Material, Untergrund, Hintergrund und Beleuchtung in einfachen Worten. Fordern Sie für ein Produktangebot eine frontal gezeigte Isolierflasche vor einem hellen Hintergrund an, gleichmässig beleuchtet, mit vollständig sichtbarer Silhouette und ohne ablenkende Szenenelemente. Wenn ein Produkt tatsächliche Abmessungen oder charakteristische Bestandteile hat, geben Sie diese Angaben ausdrücklich an. Utilitys Vorliebe für eine unkomplizierte Darstellung begründet keine Tatsachen über ein reales Produkt, die im Briefing fehlen.
Die Generierung unterstützt Prompts mit bis zu 10'000 Zeichen, Einstellungen für bevorzugte Farben und Hintergrundfarbe, einen Zufalls-Seed und ein bis sechs Ausgaben. Optionale kompatible benutzerdefinierte Stile oder Referenzbilder können die Bildsprache eines Katalogs vorgeben. Nutzen Sie Referenzmaterial mit übereinstimmender Beleuchtung und Darstellung und behalten Sie denselben kompatiblen Stil für weitere Produktbriefings bei. Eine exakte Farbübereinstimmung zwischen Referenz und Ausgabe ist nicht garantiert; vergleichen Sie das fertige Bild deshalb mit der geforderten Palette. Für die Generierung anhand von Stilreferenzen verwenden Sie 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 und die Auflösung höchstens 16 Megapixel betragen. Verwenden Sie entweder diese Referenzen oder einen kompatiblen gespeicherten Stil, nicht beides zusammen. Bei der Generierung anhand von Stilreferenzen erlaubt der flexible Abgleich eine freiere Interpretation, während der präzise Abgleich Darstellung, Palette, Komposition und Beleuchtung enger folgt.
Der separate Bild-zu-Bild-Ablauf nutzt ein vorhandenes Bild und einen Prompt; eine Stärke von 0 bis 1 steuert den Umfang der Änderung. Eine geringere Stärke hält das Ergebnis näher an der Vorlage, eine höhere lässt stärkere Abweichungen zu. Als Eingabe sind PNG, JPG, WebP oder SVG unter 20 MB mit bis zu 16 MP und Seitenlängen zwischen 256 und 4096 Pixeln möglich. Benutzerdefinierte V4.1-Stile werden bei dieser Transformation nicht akzeptiert; sie ist vom Anhängen einer Stilreferenz an eine neue Generierung zu unterscheiden.
V4.1 Utility akzeptiert keine kuratierten Stilnamen und keine Einstellungen negative_prompt, text_layout, artistic_level oder no_text. Beschreiben Sie die gewünschte fertige Szene direkt im positiven Prompt. Halten Sie bei einer Serie von Produktbildern die Vorgaben für Bildausschnitt und Hintergrund konstant und vergleichen Sie jedes Bild mit der angegebenen Produktform, dem Material und den Details, bevor Sie es in einem Layout verwenden. Das standardmässige Utility ist ein gezieltes Rasterwerkzeug für eine zurückhaltende Darstellung; wählen Sie Ausgabeformat und Ausgabe passend zur Aufgabe.
POST /v1/images/generationstext, imageimage| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits recraft/recraft-v4.1-utility | 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 |
|---|---|---|---|---|
| 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 |
| KonfigurationAusgabebild | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Ausgabebild | Gebühr Ausgabe · Ausgabebild · Schätzung nur zum Vergleich $0.07 pro Ausgabebild |
| KonfigurationGeschätzte Erzeugungskosten | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Abrechnungseinheit— | Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.07 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': 'recraft/recraft-v4.1-utility', '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
/v1/images