Recraft: Recraft V4.1

Recraft V4.1 erstellt 1K-Rasterbilder mit natürlichem Fotorealismus, ausdrucksstarker Illustration und bewusst gestalteter Komposition. Es kann eine kurze kreative Vorgabe ausarbeiten oder einem detaillierten Briefing folgen, mit optionalen Bild- und benutzerdefinierten Stileingaben.

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

Ü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 ist das Haupt-Rastermodell der V4.1-Familie von Recraft. Es ist für ausdrucksstarke Bilderzeugung ausgelegt, darunter natürlich wirkende Fotos, Illustrationen und räumlich wirkende Bildkonzepte. Der Hersteller stellt es als Modell vor, das aus einem kurzen Prompt ästhetische Entscheidungen ableiten und zugleich auf detailliertere kreative Vorgaben eingehen kann. Verwenden Sie es für Erkundung, Konzeptentwicklung und Bilder, bei denen Stimmung, Beleuchtung und Komposition zum Ergebnis gehören und nicht auf eine einfache frontale Produktansicht reduziert werden.

Der genaue Herstellercode lautet recraftv4_1. Das Modell liefert 1K-Rasterbilder als verlustfreies WebP oder PNG, mit 1024 × 1024 Pixeln im Quadrat und 1344 × 768 im Format 16:9. Weitere unterstützte Seitenverhältnisse verwenden eigene Abmessungen. V4.1 Pro ist die separate 2K-Rasterausgabe, Vector liefert bearbeitbares SVG und Utility bevorzugt einfachere Beleuchtung und Szenen. Diese Zweige dienen unterschiedlichen Ergebnissen und dürfen nicht zu einem gemeinsamen Satz von Ausgabeeigenschaften zusammengefasst werden.

Der Hersteller hebt natürlichere fotografische Szenen, ruhigere Hintergründe, weichere Farbverläufe und ein breites Illustrationsspektrum hervor. Zu seinen Beispielen zählen ausdrucksstarke Schriftzüge, flächige Figurenillustrationen und ein gezeichnetes Figurenreferenzblatt. Ein kurzer Prompt kann Interpretationsspielraum für das Modell lassen; ein detailliertes Briefing kann Motiv, Pose, Material, Hintergrund und Komposition festlegen. Geben Sie für ein räumlich wirkendes Motiv die Oberflächen- und Lichtgestaltung an und bedenken Sie, dass das Ergebnis ein Bild und kein Mesh oder bearbeitbares 3D-Projekt ist.

Fordern Sie für das Konzept eines Lesebereichs etwa ein stimmungsvolles Foto einer kleinen Leseecke mit warmem Tageslicht, Büchern und einem Keramikobjekt an, mit einer entspannten statt ausstellungsartigen Anordnung. Ein kontrolliertes Illustrationsbriefing könnte stattdessen grafisches Motiv, Farbbeziehungen und Liniengestaltung benennen. Geben Sie das geplante Seitenverhältnis und die wichtigsten visuellen Entscheidungen an. So lässt sich leichter beurteilen, ob ein unerwartetes Detail eine nützliche kreative Interpretation ist oder im nächsten Briefing geändert werden sollte.

Die Generierungsreferenz erlaubt Prompts mit bis zu 10.000 Zeichen, einen Zufalls-Seed, bevorzugte Farben und eine gewünschte Hintergrundfarbe sowie eine bis sechs Ausgaben. Optionale Referenzbilder oder kompatible gespeicherte Stile können mit flexibler oder präziser Anpassung eine Bildsprache vorgeben. Für die Hauptausgabe V4.1 sind sie nicht erforderlich. Wählen Sie saubere, untereinander stimmige Referenzen und beschreiben Sie den neuen Inhalt im Prompt; eine Farbreproduktion aus der Referenz ist nicht garantiert. 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.

V4.1 unterstützt außerdem einen separaten Bild-zu-Bild-Ablauf mit einem vorhandenen Bild, Text und strength von 0 bis 1. Dieser Vorgang steuert über strength, wie nahe das neue Bild an der Vorlage bleibt, und akzeptiert keine Steuerelemente für benutzerdefinierte V4.1-Stile. Die aktuelle Generierungsreferenz des Modells schließt negative_prompt, kuratierte Stile, text_layout, artistic_level und no_text aus. Beschreiben Sie die gewünschte Szene direkt und prüfen Sie das entstandene Asset im Ziellayout einschließlich Details, Beschnitt und etwaiger Schrift, bevor Sie eine visuelle Richtung auswählen. 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

recraft/recraft-v4.1

Recraft /recraft/recraft-v4.1

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	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
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.07 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.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

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', '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

Aliasnamen für Methodenpfade

/v1/images

Zugehörige Aufrufer-IDs

recraft/recraft-v4.1

FAQ · Recraft: Recraft V4.1

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

Recraft: Recraft V4.1