Recraft: Recraft V4 Styles
Recraft V4 Styles erzeugt 1K-Rasterbilder in einer durch Referenzen definierten Bildsprache. Es ist für die laufende Marken- und Kampagnenarbeit gedacht, bei der jedes neue Motiv dieselbe Darstellungsweise, Textur und Gesamtoptik beibehalten soll.
Ü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 ist die Standard-Rasterausgabe von Recrafts spezialisierter Generierungsfamilie für konsistente Stile. Es erstellt ein neues Bild aus einem Textprompt und folgt dabei einem Stil, der durch Referenzmaterial festgelegt wurde. Das Modell eignet sich für Serien von Illustrationen, Bannern oder Produktszenen, die eine wiedererkennbare visuelle Gestaltung teilen sollen. Die Referenz bestimmt Darstellungsweise, Textur und Farblogik; der Prompt führt Motiv und Szene für jedes neue Asset ein.
Der Hersteller führt 1K-Rasterausgaben als verlustfreies WebP oder PNG an. Das quadratische Format hat 1024 × 1024 Pixel, das dokumentierte 16:9-Format 1344 × 768; Hochformate und weitere unterstützte Seitenverhältnisse verwenden eigene Größen. Diese Ausgabe ist von der 2K-Rasterausgabe von Styles Pro und den SVG erzeugenden Vector-Modellen getrennt. Wählen Sie das Seitenverhältnis für das fertige Layout, statt anzunehmen, dass die Bezeichnung 1K bei jedem Bild dieselbe Breite und Höhe bedeutet.
Ein Stil ist verpflichtend. Verwenden Sie eine bis zehn PNG-, JPG- oder WebP-Referenzen oder einen kompatiblen Stil, der bei einer früheren Stilerstellung gespeichert wurde. Der dokumentierte Ablauf akzeptiert eine gespeicherte Stilkennung und neue Referenzen nicht gemeinsam. Referenzen können vorhandene Marken- oder Kampagnenassets sein und müssen nicht ursprünglich mit Recraft erzeugt worden sein. Sie müssen unter 20 MB pro Datei und insgesamt bei höchstens 64 MB liegen. Vor der Verwendung des Stils ist keine separate, vom Nutzer ausgeführte Trainingsaufgabe erforderlich. 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.
Beginnen Sie mit einer starken Referenz oder mehreren Referenzen, die bereits eine gemeinsame Bildsprache haben. Konsistente Referenzen helfen, den Stil über ein einzelnes Objekt oder eine Pose hinaus anzuwenden; ein uneinheitliches Moodboard kann konkurrierende Motive einbringen. Die flexible Anpassung ist die Standardeinstellung und lässt mehr Interpretationsspielraum; die präzise Anpassung folgt Darstellungsweise, Palette, Komposition und Beleuchtung der Referenz enger. Eine exakte Farbreproduktion ist dennoch nicht garantiert.
Beschreiben Sie für eine Bannerserie etwa einen Zusteller, der ein Paket vor einer Haustür abstellt, eine ruhige horizontale Komposition und Freiraum auf einer Seite für späteren Text. Nachfolgende Briefings können das Ereignis oder den Kamerawinkel ändern und dabei denselben Stil beibehalten. Der Hersteller erlaubt Prompts mit bis zu 10.000 Zeichen, bevorzugte Farben, eine gewünschte Hintergrundfarbe, einen Zufalls-Seed und ein bis sechs Bilder. negative_prompt, kuratierte Stilnamen und text_layout werden nicht unterstützt; beschreiben Sie das gewünschte Motiv und Layout daher direkt im Briefing.
Die Styles-Reihe bietet weder Bild-zu-Bild noch Inpainting. Eine Stilreferenz lenkt ein neu erzeugtes Bild, garantiert aber nicht die Erhaltung der Objekte oder Pixel der Referenz. Wenn die Serie zu gleichförmig wirkt, überarbeiten Sie Pose, Handlung, Bildausschnitt oder Szenendetails, statt eine widersprüchliche Referenz hinzuzufügen. Bewerten Sie jedes Ergebnis im geplanten Layout auf Klarheit des Motivs, nutzbaren Raum und eine stimmige Darstellungsweise und behalten Sie für das nächste Asset denselben kompatiblen Stil bei. So wird das Modell für eine wiederholbare Bildsprache mit wechselnden Inhalten praktisch nutzbar.
Ailoot Ultra · Bilder POST /v1/images/generations recraft/recraft-v4-styles
recraft/recraft-v4-stylesEinstieg
Recraft V4 Styles erzeugt 1K-Rasterbilder in einer durch Referenzen definierten Bildsprache. Es ist für die laufende Marken- und Kampagnenarbeit gedacht, bei der jedes neue Motiv dieselbe Darstellungsweise, Textur und Gesamtoptik beibehalten soll.
- 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 | 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.07 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.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
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', '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
Aliasnamen für Methodenpfade
/v1/images
Zugehörige Aufrufer-IDs
FAQ · Recraft: Recraft V4 Styles
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/images/generations·recraft/recraft-v4-styles:text,image→image- Welche Felder verwendet die Anfrage?
POST /v1/images/generations·recraft/recraft-v4-styles:model,prompt,aspect_ratio,n,input_references,provider- Welche Grenzen gelten?
POST /v1/images/generations·recraft/recraft-v4-styles:n.minimum:1;n.maximum:6