Modelle

Recraft: Recraft V4.1 Utility

Markdown · JSON

Recraft: Recraft V4.1 Utility

Recraft V4.1 Utility erzeugt 1K-Rasterbilder für geradlinige Produktaufnahmen, Mockups und einfache Szenen. Es bevorzugt gleichmäßige Beleuchtung und frontale Kompositionen. Textprompts sowie optionale Bild- oder Stileingaben sorgen für eine vorhersehbare Bildsprache.

Ü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 Utility ist das standardmäßige Utility-Rastermodell der V4.1-Familie von Recraft. Es bevorzugt einfache Szenen, gleichmäßige Beleuchtung und frontale Kompositionen gegenüber den ausdrucksstärkeren Perspektiven, Licht- und Stimmungsentscheidungen des Hauptmodells V4.1. Seine praktische Aufgabe ist eine klare Produktaufnahme oder ein Mockup, bei dem das Objekt und die erforderlichen Details im Vordergrund stehen. Diese Utility-Ausgabe unterscheidet sich von Utility Pro, dem Hauptmodell V4.1 und den Vektorvarianten mit SVG-Ausgabe.

Der Modellcode des Herstellers lautet recraftv4_1_utility. Das Modell liefert 1K-Rasterbilder als verlustfreies WebP oder PNG; die Größen ergeben sich aus den unterstützten Seitenverhältnissen. Ein quadratisches Bild hat 1024 × 1024 Pixel, ein Bild im Format 4:3 hat 1216 × 896 Pixel. Die Pro-Utility-Ausgabe verwendet größere 2K-Abmessungen. Diese Ausgabegrößen dürfen daher nicht der Standardausgabe Utility zugeschrieben werden. Wählen Sie das Format der vorgesehenen Produktdarstellung oder des Mockups, bevor Sie die Szene beschreiben.

Ein nützliches Briefing benennt Produkt, Perspektive, Material, Untergrund, Hintergrund und Beleuchtung in einfachen Worten. Fordern Sie für eine Produktanzeige eine frontal aufgenommene Isolierflasche vor einem hellen Hintergrund an, gleichmäßig ausgeleuchtet, mit vollständig sichtbarer Silhouette und ohne ablenkende Szenenelemente. Hat ein Produkt tatsächliche Abmessungen oder charakteristische Bauteile, geben Sie diese ausdrücklich an. Utilitys Vorliebe für eine geradlinige Darstellung liefert keine Fakten über ein reales Produkt, die im Briefing fehlen.

Die Generierung unterstützt Prompts mit bis zu 10.000 Zeichen, Vorgaben für bevorzugte Farben und die Hintergrundfarbe, einen Zufalls-Seed sowie ein bis sechs Ausgaben. Optionale kompatible benutzerdefinierte Stile oder Referenzbilder können die Bildsprache eines Katalogs vorgeben. Verwenden Sie Referenzmaterial mit übereinstimmender Beleuchtung und Darstellung und behalten Sie für weitere Produktbriefings denselben kompatiblen Stil bei. Eine exakte Farbübertragung von der Referenz auf das Ergebnis ist nicht garantiert. Vergleichen Sie deshalb das fertige Bild mit der erforderlichen Palette. Verwenden Sie für die Generierung mit Stilreferenzen ein bis zehn PNG-, JPG- oder WebP-Bilder, zusammen höchstens 64 MB und jeweils unter 20 MB. Bei jeder Referenz muss die kürzeste Seite mindestens 256 Pixel und 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.

Der separate Image-to-Image-Workflow verwendet ein vorhandenes Bild und einen Prompt. Die Stärke von 0 bis 1 steuert das Ausmaß der Veränderung. Eine geringere Stärke hält das Ergebnis näher am Ausgangsbild, eine höhere lässt stärkere Abweichungen zu. Als Eingabe sind PNG, JPG, WebP oder SVG unter 20 MB mit höchstens 16 MP und Seitenlängen zwischen 256 und 4096 Pixeln möglich. Benutzerdefinierte V4.1-Stile werden in diesem Transformationsvorgang nicht akzeptiert. Er unterscheidet sich vom Hinzufügen einer Stilreferenz bei einer neuen Generierung.

V4.1 Utility akzeptiert keine kuratierten Stilnamen und keine Steuerelemente 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 Bildausschnitt und Hintergrundvorgaben konstant und vergleichen Sie jedes Bild mit der angegebenen Produktform, dem Material und den Details, bevor Sie es in ein Layout übernehmen. Standard-Utility ist ein gezieltes Rasterwerkzeug für eine zurückhaltende Darstellung. Wählen Sie das konkrete Ausgabeformat und die Ausgabe passend zur Aufgabe.

Ailoot Ultra · Bilder POST /v1/images/generations recraft/recraft-v4.1-utility

recraft/recraft-v4.1-utility

Recraft /recraft/recraft-v4.1-utility

Start

Recraft V4.1 Utility erzeugt 1K-Rasterbilder für geradlinige Produktaufnahmen, Mockups und einfache Szenen. Es bevorzugt gleichmäßige Beleuchtung und frontale Kompositionen. Textprompts sowie optionale Bild- oder Stileingaben sorgen für eine vorhersehbare Bildsprache.

Zulässige Eingaben
Text · Bilder
Ergebnisse
Bilder

In Ailoot verfügbar · Eingaben und Methoden

Ailoot Ultra · Bilder POST /v1/images/generations
Eingabetypen
text, image
Ausgabetypen
image
FeldTypAnforderungWerte und LimitsStandard
FeldmodelTypstringAnforderungErforderlichWerte und Limits
recraft/recraft-v4.1-utility
Standard—
FeldpromptTypstringAnforderungErforderlichWerte und Limits
Mindestlänge: 1
Standard—
Feldaspect_ratioTypstringAnforderungOptionalWerte und Limits
1:1, 4:3, 3:4, 16:9, 9:16, auto
Standard—
FeldnTypintegerAnforderungOptionalWerte und Limits
Minimum: 1
Maximum: 6
Standard—
Feldinput_referencesTyparrayAnforderungOptionalWerte und Limits
Mindestanzahl Elemente: 0
Maximale Anzahl Elemente: 1
Standard—
FeldproviderTypobjectAnforderungOptionalWerte und LimitsStandard—
Methodenparameter und Lebenszyklus
ParameterVertrag
Parametercontent_typeVertragapplication/json
ParameterrequiredVertragmodel, prompt
Parametermaterial_typesVertragtext, 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}

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
KonfigurationBasistarife für TokenTarifstaffelGrundtarifPrognostizierte 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
KonfigurationAusgabebildTarifstaffel—Prognostizierte Menge—Abrechnungseinheitpro AusgabebildGebühr
Ausgabe · Ausgabebild · Schätzung nur zum Vergleich $0.07 pro Ausgabebild
KonfigurationGeschätzte GenerierungskostenTarifstaffel—Prognostizierte MengeSchätzung für eine GenerierungAbrechnungseinheit—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 abschließenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →

Beispielanfragen

Ailoot Ultra · Bilder

curl
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'recraft/recraft-v4.1-utility', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        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"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

Ergebnisse abrufen und speichern

Ailoot Ultra · Bilder

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

  • GET /v1/media/tasks/{task_id}
  • GET /v1/media/assets/{asset_id}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Abrufe anderer Inhalte
Vorhandene eigene Dateien abrufen
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
Alle fertiggestellten Ergebnisse aufbewahren

Speichern 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.

Wenn die ursprüngliche Antwort geprüft werden muss

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.

Antwortfelder
FeldTyp
FeldcreatedTyp
Felddata[].urlTyp
Felddata[].b64_jsonTyp
FeldusageTyp

Aliasnamen

Modellaliasnamen

Ailoot Ultra recraft/recraft-v4.1-utility

Aliasnamen für Methodenpfade

/v1/images

Zugehörige Aufrufer-IDs

recraft/recraft-v4.1-utility

FAQ · Recraft: Recraft V4.1 Utility
Welche Eingaben und Ergebnisse sind verfügbar?

POST /v1/images/generations · recraft/recraft-v4.1-utility: text, image → image

Welche Felder verwendet die Anfrage?

POST /v1/images/generations · recraft/recraft-v4.1-utility: model, prompt, aspect_ratio, n, input_references, provider

Welche Grenzen gelten?

POST /v1/images/generations · recraft/recraft-v4.1-utility: n.minimum: 1; n.maximum: 6

Weitere Details

Verbinden Sie Ailoot mit Claude Code, OpenCode, Hermes oder Ihrer eigenen Anwendung.

Das Unternehmen und sein Projektportfolio

Das Unternehmen und sein Projektportfolio: Millionen von Kunden; monatliche Umsätze in Milliardenhöhe.

Tokens mit Rabatt kaufen.

Aborabatt für regelmäßige Arbeit. Aktionscodes bieten bis 50% beim Tokenkauf.

Abo
Wählen Sie einen Tarif mit Rabatt für Ihre regelmäßigen Anfragen.
Aktionscode bis 50%
Geben Sie den Code beim Kauf ein. Der Preis wird nach den gültigen Aktionsbedingungen berechnet.
Ausgaben in der Historie
Modell, Tokens und Betrag werden für jede Anfrage gespeichert.

Abo wählen · Modellpreise ansehen

Verbinden Sie die API mit dem Produkt, das Sie verkaufen.

SaaS, Anwendungen und Bots nach dem offiziellen Angebot und Lizenzvertrag von Ailoot. Fordern Sie für den Weiterverkauf eine Reseller-Lizenz an.

Kommerzielle Anwendung
Integrieren Sie Text-, Bild-, Video- und Audioerzeugung in kostenpflichtige Funktionen Ihres Dienstes.
Reseller-Lizenz
Senden Sie Projektbeschreibung und Zugangsmodell. Fordern Sie schriftliche Nutzungs- und Weiterverkaufsbedingungen an.
Dokumente auf der Website
Offizielles Angebot, Lizenzvertrag und Datenschutzerklärung sind vor der Verbindung zugänglich.

Reseller-Lizenz anfordern · Offizielles Angebot und Lizenzvertrag