Recraft: Recraft V4 Styles Pro
Recraft V4 Styles Pro erzeugt 2K-Rasterbilder in einem durch Referenzen vorgegebenen visuellen Stil. Es ist für detailreiche Kampagnenassets und Bildserien gedacht, deren Textur, Darstellungsweise, Palette und Gesamteindruck bei wechselnden Motiven konsistent bleiben sollen.
Ü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 Styles Pro ist das höher auflösende Rastermodell von Recrafts spezialisierter V4-Styles-Familie. Es erstellt ein neues Bild aus einem Textbriefing und einem visuellen Stil, der über Referenzbilder oder einen gespeicherten Stil vorgegeben wird. Das Modell ist für Kampagnen, Markenillustrationen und andere Bildserien gedacht, bei denen Darstellungsweise, Textur und kompositorischer Charakter von einem Asset auf das nächste übertragen werden sollen. Es ist von Recraft V4 Pro und V4.1 Pro getrennt, bei denen die Stileingabe optional und nicht die bestimmende Voraussetzung des Modells ist.
Styles Pro erzeugt 2K-Rasterausgaben in den Formaten verlustfreies WebP oder PNG. Eine quadratische Ausgabe in der Größentabelle des Herstellers hat 2048 × 2048 Pixel, eine Ausgabe im Format 16:9 hat 2688 × 1536 Pixel; weitere unterstützte Seitenverhältnisse haben eigene Abmessungen. Pros größere Ausgabe kann für detailreiche Kampagnenmotive und größere Layouts nützlich sein. Die Vektorvarianten erzeugen hingegen SVG und haben keine feste Pixelgröße; wählen Sie diese Raster-Pro-Ausgabe daher nicht, wenn das gewünschte Ergebnis eine bearbeitbare Vektordatei ist.
Jede Generierung in der Styles-Familie benötigt einen Stil. Stellen Sie ein bis zehn PNG-, JPG- oder WebP-Referenzbilder bereit oder verwenden Sie einen kompatiblen gespeicherten Stil erneut; eine Stilkennung und neue Referenzen sind alternative Eingaben, die nicht miteinander kombiniert werden. Der Herstellerablauf erlaubt insgesamt bis zu 64 MB an Referenzen, wobei jede Datei unter 20 MB bleiben muss. Die Stilerstellung erfordert keinen vom Nutzer ausgeführten Trainingsschritt. Eine klare Referenz kann eine stimmige Richtung vorgeben; mehrere Referenzen helfen, wenn sie bereits dieselbe Bildsprache teilen, statt konkurrierende Erscheinungsbilder zu zeigen. Jede Referenz muss eine kürzeste Seite von mindestens 256 Pixeln, eine längste Seite von höchstens 4.096 Pixeln und eine Gesamtauflösung von höchstens 16 Megapixeln haben.
Die flexible Stilanpassung ist die Standardeinstellung und erlaubt eine freiere Interpretation der Referenz. Die präzise Anpassung folgt Darstellungsweise, Palette, Komposition und Beleuchtung enger. Die Referenz legt die Bildsprache fest; das Textbriefing muss weiterhin das neue Motiv, die Handlung, die Szene und den Bildausschnitt beschreiben. Geben Sie für eine detailreiche Produktkampagne etwa eine Glasflasche auf einer hellen Steinoberfläche, eine Dreiviertelansicht, weiches Seitenlicht und freien Platz für eine Überschrift vor, während die bereitgestellte Referenz die fotografische Gestaltung bestimmt.
Das Modell akzeptiert Prompts mit bis zu 10.000 Zeichen, unterstützt bevorzugte Farben und eine gewünschte Hintergrundfarbe und kann einen Zufalls-Seed verwenden. Der dokumentierte Generierungsablauf kann ein bis sechs Bilder zurückgeben. Seine nützlichen Steuerelemente unterscheiden sich von älteren Recraft-Ausgaben: Kuratierte Stilnamen, negative_prompt und text_layout werden nicht unterstützt; die Styles-Familie bietet außerdem weder Bild-zu-Bild noch Inpainting. Eine Referenz ist eine Stilquelle, keine Maske und keine Anweisung, ein vorhandenes Foto Pixel für Pixel zu erhalten.
Bereiten Sie sauberes, ausreichend detailliertes Referenzmaterial vor und verwenden Sie bei der Entwicklung einer Serie denselben Stil erneut. Wenn die Ausgaben zu ähnlich werden, ändern Sie Motiv, Pose, Kamerawinkel oder Szene im Textbriefing, statt eine unpassende Referenz hinzuzufügen. Eine exakte Farbübereinstimmung zwischen Referenz und Ausgabe ist nicht garantiert; Vorgaben für bevorzugte Farben geben eine Richtung vor und ersetzen keine Farbprüfung. Beurteilen Sie das fertige Kampagnenasset in der geplanten Anzeige- oder Druckgröße und prüfen Sie, ob Motiv, nutzbarer Freiraum und visuelle Gestaltung zum Briefing passen.
Ailoot Ultra · Bilder POST /v1/images/generations recraft/recraft-v4-styles-pro
recraft/recraft-v4-styles-proEinstieg
Recraft V4 Styles Pro erzeugt 2K-Rasterbilder in einem durch Referenzen vorgegebenen visuellen Stil. Es ist für detailreiche Kampagnenassets und Bildserien gedacht, deren Textur, Darstellungsweise, Palette und Gesamteindruck bei wechselnden Motiven konsistent bleiben sollen.
- 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-styles-pro | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits Mindestlänge: 1 | Standard— |
Feldaspect_ratio | Typstring | AnforderungOptional | Werte und Limits 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 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: 1 Maximale Anzahl Elemente: 10 | 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 | Abrechnungsbedingungen | Gebühr |
|---|---|---|---|---|---|
| KonfigurationBasistarife für Tokens | TarifstaffelGrundtarif | Prognostizierte Menge— | Abrechnungseinheit— | Abrechnungsbedingungen— | 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 |
| KonfigurationEingabereferenz | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Anfrage | AbrechnungsbedingungenStilerstellung bei der Generierung mit Stilreferenzen; einmal je Anfrage, zusätzlich zum Preis des Ausgabebildes. | Gebühr Eingabe · Eingabereferenz · Schätzung nur zum Vergleich $0.01 pro Anfrage |
| KonfigurationAusgabebild | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Ausgabebild | Abrechnungsbedingungen— | Gebühr Ausgabe · Ausgabebild · Schätzung nur zum Vergleich $0.2 pro Ausgabebild |
| KonfigurationGeschätzte Generierungskosten | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Abrechnungseinheit— | Abrechnungsbedingungen— | Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.2 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-styles-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-styles-pro
Aliasnamen für Methodenpfade
/v1/images
Zugehörige Aufrufer-IDs
FAQ · Recraft: Recraft V4 Styles Pro
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/images/generations·recraft/recraft-v4-styles-pro:text,image→image- Welche Felder verwendet die Anfrage?
POST /v1/images/generations·recraft/recraft-v4-styles-pro:model,prompt,aspect_ratio,n,input_references,provider- Welche Grenzen gelten?
POST /v1/images/generations·recraft/recraft-v4-styles-pro:n.minimum:1;n.maximum:6