Recraft: Recraft V4.1 Utility Pro

Recraft V4.1 Utility Pro erzeugt Rasterbilder in 2K mit Schwerpunkt auf einfachen, vorhersehbaren Szenen, gleichmässiger Beleuchtung und frontaler Komposition. Es eignet sich für detailreiche Produktaufnahmen und Mockups, die eine klare Darstellung statt einer ausdrucksstarken künstlerischen Richtung benötigen.

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

Ü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 Pro ist die höher auflösende Rastervariante des Utility-Zweigs innerhalb von Recraft V4.1. Der Hersteller unterscheidet Utilitys unkomplizierte Darstellung von der ausdrucksstärkeren Wahl von Blickwinkel, Beleuchtung und Komposition beim Hauptmodell V4.1. Utility bevorzugt einfache Szenen, gleichmässige Beleuchtung und frontal gezeigte Motive. Es eignet sich daher für Bilder in Produktangeboten, Mockups und andere Arbeiten, 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 eine 2K-Rasterausgabe mit feineren Details als verlustfreies WebP oder PNG. Die Grössentabelle gibt 2048 × 2048 Pixel für quadratische Bilder und 2432 × 1792 für 4:3 an; andere unterstützte Seitenverhältnisse verwenden eigene Abmessungen. Dies trennt Utility Pro von der 1K-Ausgabe des standardmässigen Utility. Es macht das Bild nicht zu einer bearbeitbaren Vektordatei; für diesen Zweck liefert eine Vector-Ausgabe SVG.

Beginnen Sie mit einem Briefing, das Objekt, Material, Blickwinkel, Hintergrund und die wenigen zwingend sichtbaren Details benennt. Fordern Sie für ein Produktangebot ein frontal gezeigtes keramisches Vorratsgefäss auf einer hellen neutralen Fläche, gleichmässige Beleuchtung, einen geschlossenen Deckel und freien Platz um die Silhouette an. Wenn die Szene einfach bleiben muss, sagen Sie das ausdrücklich, statt darauf zu vertrauen, dass der Name Utility alle Darstellungsentscheidungen vorgibt. Halten Sie bei einer Serie von Angebotsbildern die Anforderungen an Bildausschnitt und Hintergrund konstant und ändern Sie die Produktbeschreibung.

Die V4.1-Generierungsreferenz unterstützt Prompts mit bis zu 10'000 Zeichen, Einstellungen für bevorzugte Farben und Hintergrundfarbe, einen Zufalls-Seed und ein bis sechs Ausgaben. Ein kompatibler gespeicherter Stil oder optionale Referenzbilder können das Erscheinungsbild führen; die spezialisierte V4-Styles-Familie ist die separate Reihe, in der ein Stil immer erforderlich ist. Nutzen Sie für optionale Referenzen klare Bilder mit übereinstimmender visueller Richtung. Eine exakte Farbwiedergabe aus einer Referenz ist nicht garantiert; eine Markenfarbvorgabe erfordert daher weiterhin ein ausdrückliches Briefing und die Prüfung der Ausgabe. 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.

Recraft dokumentiert für die V4.1-Reihe auch Bild-zu-Bild, wobei ein vorhandenes Bild mit einem Prompt und einer Stärke von 0 bis 1 kombiniert wird. Eine geringere Stärke bleibt näher an der Vorlage, eine höhere erlaubt eine grössere Änderung. Das ist hilfreich, wenn Ausgangskomposition oder Motiv eine neue Version prägen sollen. Einstellungen für benutzerdefinierte V4.1-Stile werden in derselben Transformation nicht akzeptiert. Die Bildeingabegrenzen des Herstellers liegen bei 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 gewünschte Szene positiv und reservieren Sie bei Bedarf exakte Schrift- oder Layoutarbeit für einen geeigneten abschliessenden Arbeitsschritt. Prüfen Sie ein Produktmotiv auf das gelieferte Material, die Form und die notwendigen Details, bevor Sie es als originalgetreues Angebotsbild behandeln. Das nützliche Ergebnis ist eine grössere Rasterkomposition für ein klares Produkt- oder Mockup-Briefing; die genauen Produkttatsachen bleiben dabei diejenigen, die in der Aufgabe vorgegeben wurden.

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

recraft/recraft-v4.1-utility-pro

Recraft /recraft/recraft-v4.1-utility-pro

Einstieg

Zulässige Eingaben: Text · Bilder
Ergebnisse: Bilder

In Ailoot verfügbar · Eingaben und Methoden

Ailoot Ultra · Bilder POST /v1/images/generations

Eingabe: text, image
Ausgabe: image

Feld	Typ	Anforderung	Werte und Limits	Standard
Feld`model`	Typ`string`	AnforderungErforderlich	Werte und Limits recraft/recraft-v4.1-utility-pro	Standard—
Feld`prompt`	Typ`string`	AnforderungErforderlich	Werte und Limits Mindestlänge: 1	Standard—
Feld`aspect_ratio`	Typ`string`	AnforderungOptional	Werte und Limits 1:1, 4:3, 3:4, 16:9, 9:16, auto	Standard—
Feld`n`	Typ`integer`	AnforderungOptional	Werte und Limits Minimum: 1 Maximum: 6	Standard—
Feld`input_references`	Typ`array`	AnforderungOptional	Werte und Limits Mindestanzahl Elemente: 0 Maximale Anzahl Elemente: 1	Standard—
Feld`provider`	Typ`object`	AnforderungOptional	Werte und Limits	Standard—

Methodenparameter und Lebenszyklus

Parameter	Vertrag
Parameter`content_type`	Vertragapplication/json
Parameter`required`	Vertragmodel, prompt
Parameter`material_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}

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.

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.42 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.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 abschliessenden 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-pro', '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

Feld	Typ
Feld`created`	Typ
Feld`data[].url`	Typ
Feld`data[].b64_json`	Typ
Feld`usage`	Typ

Aliasnamen

Modellaliasnamen

Ailoot Ultra recraft/recraft-v4.1-utility-pro

Aliasnamen für Methodenpfade

/v1/images

Zugehörige Aufrufer-IDs

recraft/recraft-v4.1-utility-pro

FAQ · Recraft: Recraft V4.1 Utility Pro

Welche Eingaben und Ergebnisse sind verfügbar?: POST /v1/images/generations · recraft/recraft-v4.1-utility-pro: text, image → image
Welche Felder verwendet die Anfrage?: POST /v1/images/generations · recraft/recraft-v4.1-utility-pro: model, prompt, aspect_ratio, n, input_references, provider
Welche Grenzen gelten?: POST /v1/images/generations · recraft/recraft-v4.1-utility-pro: n.minimum: 1; n.maximum: 6

Recraft: Recraft V4.1 Utility Pro