Recraft: Recraft V4.1 Utility Pro
Recraft V4.1 Utility Pro erzeugt 2K-Rasterbilder mit Schwerpunkt auf einfachen, vorhersehbaren Szenen, gleichmäßigem Licht und frontalen Kompositionen. Es eignet sich für detailreiche Produktaufnahmen und Mockups, die eine klare Präsentation statt einer ausdrucksstarken gestalterischen Richtung benötigen.
Ü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 Präsentation von den ausdrucksstärkeren Entscheidungen zu Perspektive, Beleuchtung und Komposition des Hauptmodells V4.1. Utility bevorzugt einfache Szenen, gleichmäßiges Licht 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 führt 2K-Rasterausgaben mit feineren Details als verlustfreies WebP oder PNG an. Die Größentabelle nennt 2048 × 2048 Pixel für quadratische Bilder und 2432 × 1792 für 4:3; weitere unterstützte Seitenverhältnisse verwenden eigene Abmessungen. Das grenzt Utility Pro von der 1K-Ausgabe des standardmäßigen Utility ab. Es verwandelt das Bild nicht in eine bearbeitbare Vektordatei; dafür 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 etwa ein frontal dargestelltes Vorratsgefäß aus Keramik auf einer hellen neutralen Oberfläche, gleichmäßige Beleuchtung, einen geschlossenen Deckel und freien Platz um die Silhouette an. Wenn die Szene schlicht bleiben soll, sagen Sie das ausdrücklich, statt sich darauf zu verlassen, dass der Name Utility alle Präsentationsentscheidungen vorgibt. Halten Sie für eine Serie von Produktangebotsbildern 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, Vorgaben für bevorzugte Farben und Hintergrundfarbe, einen Zufalls-Seed und eine bis sechs Ausgaben. Ein kompatibler gespeicherter Stil oder optionale Referenzbilder können das Erscheinungsbild lenken; die spezialisierte V4-Styles-Familie ist die separate Reihe, in der ein Stil immer verpflichtend ist. Verwenden Sie für optionale Referenzen klare Assets mit übereinstimmender visueller Richtung. Eine exakte Farbreproduktion aus einer Referenz ist nicht garantiert; eine Markenfarbvorgabe benötigt daher weiterhin ein ausdrückliches Briefing und eine Kontrolle der Ausgabe. Verwenden Sie für die Generierung im Referenzstil ein bis zehn PNG-, JPG- oder WebP-Bilder mit insgesamt höchstens 64 MB und weniger als 20 MB pro Datei. Jede Referenz benötigt eine kürzeste Seite von mindestens 256 Pixeln, eine längste Seite von höchstens 4.096 Pixeln und eine Auflösung von höchstens 16 Megapixeln. Verwenden Sie entweder diese Referenzen oder einen kompatiblen gespeicherten Stil, nicht beides zugleich. Bei der Generierung im Referenzstil erlaubt die flexible Anpassung eine freiere Interpretation, während die präzise Anpassung Darstellungsweise, Palette, Komposition und Beleuchtung enger folgt.
Recraft dokumentiert außerdem Bild-zu-Bild für die V4.1-Reihe; dabei werden ein vorhandenes Bild, ein Prompt und strength von 0 bis 1 kombiniert. Ein niedrigerer Wert bleibt näher an der Vorlage, ein höherer erlaubt eine stärkere Änderung. Das ist hilfreich, wenn die Ausgangskomposition oder das Motiv eine neue Version prägen soll. Derselbe Transformationsvorgang akzeptiert keine Steuerelemente für benutzerdefinierte V4.1-Stile. 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 geplante Szene positiv und verlagern Sie bei Bedarf präzise Schrift- oder Layoutarbeit in einen geeigneten Fertigstellungsschritt. Prüfen Sie ein Produktmotiv auf das vorgegebene Material, die Form und erforderliche Details, bevor Sie es als originalgetreues Asset für ein Produktangebot behandeln. Das nützliche Ergebnis ist eine größere Rasterkomposition, die für ein klares Produkt- oder Mockup-Briefing vorbereitet wurde; die genauen Produktfakten bleiben jene, die in der Aufgabe bereitgestellt wurden.
Ailoot Ultra · Bilder POST /v1/images/generations recraft/recraft-v4.1-utility-pro
recraft/recraft-v4.1-utility-pro
recraft/recraft-v4.1-utility-proEinstieg
Recraft V4.1 Utility Pro erzeugt 2K-Rasterbilder mit Schwerpunkt auf einfachen, vorhersehbaren Szenen, gleichmäßigem Licht und frontalen Kompositionen. Es eignet sich für detailreiche Produktaufnahmen und Mockups, die eine klare Präsentation statt einer ausdrucksstarken gestalterischen Richtung benötigen.
- 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 |
|---|---|---|---|---|
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— |
Methodenparameter und Lebenszyklus
| 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}
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 |
|---|---|---|---|---|
| KonfigurationBasistarife für Tokens | 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 · In Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · In 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 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 →
Beispielanfragen
Ailoot Ultra · Bilder
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}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Abrufe anderer Inhalte
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 |
|---|---|
Feldcreated | Typ |
Felddata[].url | Typ |
Felddata[].b64_json | Typ |
Feldusage | Typ |
Aliasnamen
Modellaliasnamen
Ailoot Ultra recraft/recraft-v4.1-utility-pro
Aliasnamen für Methodenpfade
/v1/images
Zugehörige Aufrufer-IDs
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