Recraft: Recraft V4.1 Pro
Recraft V4.1 Pro erzeugt detailreiche 2K-Rasterbilder für ausdrucksstarke Fotografie, Illustration und größere Kreativassets. Es verbindet den natürlichen Fotorealismus und die Interpretation kurzer Prompts von V4.1 mit optionalen Stilreferenzen und Bild-zu-Bild-Abläufen.
Ü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 Pro ist die höher auflösende Rasterausgabe der ausdrucksstarken V4.1-Generierungsfamilie von Recraft. Der Hersteller betont natürlichen Fotorealismus, bewusst gestaltete Kompositionen und Illustrationsstile, die sich aus einer kurzen kreativen Vorgabe entwickeln lassen. Pro ist für Aufgaben gedacht, bei denen feinere Details und ein größeres Rasterergebnis wichtig sind, darunter umfangreiche Marketingmotive und druckorientierte Layouts. Es unterscheidet sich von der einfacheren Darstellung von Utility Pro und von der bearbeitbaren SVG-Ausgabe von Pro Vector.
Das genaue Modell heißt recraftv4_1_pro. Die Herstellerreferenz führt 2K-Ausgaben als verlustfreies WebP oder PNG an. Das quadratische Format hat 2048 × 2048 Pixel, 16:9 hat 2688 × 1536 und 3:4 hat 1792 × 2432 Pixel; weitere zulässige Seitenverhältnisse sind jeweils eigenen Abmessungen zugeordnet. Verwenden Sie ein zum geplanten Layout passendes Seitenverhältnis oder eine exakte Größe aus der Herstellertabelle. Der Name Pro macht nicht jede Komposition quadratisch und verwandelt ein Rasterbild nicht in Vektorgeometrie.
V4.1 kann eine knappe Vorgabe interpretieren und dabei Entscheidungen zu Licht, Stimmung und Komposition ergänzen. Das eignet sich zum Erkunden eines redaktionellen Fotos, einer stilisierten Illustration oder eines räumlich wirkenden Motivs mit reflektierenden Materialien. Eine gerenderte 3D-Optik bleibt ein Bild und ist keine bearbeitbare dreidimensionale Szene. Wenn eine bestimmte gestalterische Richtung erforderlich ist, beschreiben Sie Motiv und Szene, Bildausschnitt, Materialverhalten, Lichtrichtung, Hintergrund und visuelle Hierarchie, statt zu erwarten, dass ein offener Prompt jedes Detail wie gewünscht auflöst.
Fordern Sie für ein redaktionelles Foto etwa eine Nahaufnahme einer Lampe aus gebürstetem Metall bei weichem Fensterlicht, ein warmes, bewohnt wirkendes Interieur und eine ruhige Komposition mit Platz für eine Bildunterschrift an. Ein stärker illustratives Briefing könnte große Farbflächen, eine lebendige Figurenpose und einen zurückhaltenden Hintergrund vorgeben. Nennen Sie den Verwendungszweck und die Details, die das Motiv auszeichnen, und prüfen Sie die größere Ausgabe anschließend auf Material, Anatomie und Komposition. Das Ergebnis ist ein vom Briefing gelenktes Kreativasset, keine Beobachtung einer realen Szene.
Die Generierung akzeptiert Prompts mit bis zu 10.000 Zeichen, bevorzugte Farben, eine gewünschte Hintergrundfarbe, einen Zufalls-Seed und eine bis sechs Ausgaben. Optionale Stilreferenzen oder kompatible gespeicherte Stile können mit flexibler oder präziser Anpassung eine wiederkehrende visuelle Gestaltung vorgeben. Verwenden Sie stimmige, klare Referenzen und beschreiben Sie den Inhalt im Prompt; eine exakte Farbübernahme aus einer Referenz ist nicht garantiert. V4.1 schließt negative_prompt, kuratierte Stilnamen, text_layout, artistic_level und no_text aus. Diese Steuerelemente dürfen daher nicht aus älteren Ausgaben übernommen werden. 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.
Recrafts separater Bild-zu-Bild-Vorgang unterstützt die V4.1-Familie mit einem vorhandenen Bild, einem Prompt und strength von 0 bis 1. Er kann Aspekte der Vorlage erhalten und andere verändern; niedrigere Werte bleiben näher an der Vorlage, höhere erlauben mehr Veränderung. Dieser Vorgang nimmt keine Steuerelemente für benutzerdefinierte V4.1-Stile an. Bereiten Sie das Quellbild innerhalb der dokumentierten Bildgrenzen vor und nennen Sie sowohl die gewünschte Änderung als auch jene Eigenschaften, die das neue Ergebnis prägen sollen. Prüfen Sie ein fertiges Asset in der tatsächlichen Komposition, insbesondere feine Details, Schrift und Beschnitt. Stellen Sie für Bild-zu-Bild PNG, JPG, WebP oder SVG unter 20 MB mit höchstens 16 Megapixeln und beiden Seiten zwischen 256 und 4.096 Pixeln bereit.
Ailoot Ultra · Bilder POST /v1/images/generations recraft/recraft-v4.1-pro
recraft/recraft-v4.1-proEinstieg
Recraft V4.1 Pro erzeugt detailreiche 2K-Rasterbilder für ausdrucksstarke Fotografie, Illustration und größere Kreativassets. Es verbindet den natürlichen Fotorealismus und die Interpretation kurzer Prompts von V4.1 mit optionalen Stilreferenzen und Bild-zu-Bild-Abläufen.
- 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-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-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-pro
Aliasnamen für Methodenpfade
/v1/images
Zugehörige Aufrufer-IDs
FAQ · Recraft: Recraft V4.1 Pro
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/images/generations·recraft/recraft-v4.1-pro:text,image→image- Welche Felder verwendet die Anfrage?
POST /v1/images/generations·recraft/recraft-v4.1-pro:model,prompt,aspect_ratio,n,input_references,provider- Welche Grenzen gelten?
POST /v1/images/generations·recraft/recraft-v4.1-pro:n.minimum:1;n.maximum:6