Recraft: Recraft V4.1 Vector
Recraft V4.1 Vector generiert bearbeitbare SVG-Logos, Schrift und Illustrationen aus Text mit optionalen Bild- und Stileingaben. Es ist die Standard-Vektorausgabe von V4.1 für Grafiken, die skalierbare Geometrie und spätere Designanpassungen 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 Vector ist das Standard-SVG-Modell in Recrafts V4.1-Familie. Es erstellt Illustrationen, Logos und Schrift, die sich umformen, umfärben und als Vektorgrafiken verwenden lassen. Es akzeptiert ein Textbriefing und kann über die dokumentierten Stil- oder Image-to-Image-Abläufe des Herstellers mit Bildeingaben arbeiten. Das resultierende SVG ist ein anderes Ergebnis als das WebP- oder PNG-Rasterbild von V4.1; diese Ausgabe soll über das Vektorformat statt über eine Rasterauflösungsbezeichnung identifiziert werden.
Die exakte Variante lautet recraftv4_1_vector und unterscheidet sich von recraftv4_1_pro_vector und den Utility-Vector-Modellen. Laut Größenanleitung akzeptieren alle Vektorvarianten vierzehn Seitenverhältnisse als Verhältnis von Breite zu Höhe und erzeugen SVG ohne feste Pixelmaße. Nutzen Sie diese Proportion zur Festlegung der gewünschten Komposition, etwa eines quadratischen Icons oder eines breiten Logos. Die spätere Darstellungsgröße lässt sich dann im Designablauf wählen, statt durch eine 1K-Rasterausgabe festgelegt zu sein.
Der Hersteller positioniert V4.1 Vector für ausdrucksstarke Typografie und klare Illustration. Ein hilfreiches Briefing benennt Objekt oder Wort, geometrischen Charakter, Linienstärke, Füllgestaltung und Farbsystem. Verlangen Sie für ein Bäckereisymbol eine kleine Grafik mit einem gebogenen Getreidehalm, einer kräftigen Silhouette und warmen zweifarbigen Füllungen. Benennen Sie wichtige räumliche Beziehungen ausdrücklich, statt sich auf eine allgemeine Formulierung wie „modernes Logo“ zu verlassen. Halten Sie für eine Icon-Familie die strukturellen Regeln stabil und variieren Sie das benannte Objekt.
Optionale benutzerdefinierte Stile können dieselbe visuelle Gestaltung über kompatible gespeicherte Stile oder Referenzbilder führen. V4.1 unterstützt bevorzugte Farben, eine gewünschte Hintergrundfarbe, einen Zufalls-Seed und Prompts mit bis zu 10.000 Zeichen; der Generierungsablauf kann ein bis sechs Ausgaben liefern. Ein Referenzstil ist für dieses Modell der Hauptlinie optional und muss mit dem Modell kompatibel sein, mit dem er erstellt wurde. Verwenden Sie klare Referenzen aus derselben visuellen Welt; eine exakte Farbübereinstimmung zwischen Referenz und Ausgabe ist nicht garantiert. Verwenden Sie für die Generierung mit Stilreferenzen ein bis zehn PNG-, JPG- oder WebP-Bilder mit insgesamt höchstens 64 MB und jeweils unter 20 MB. 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. Bei der Generierung mit Stilreferenzen erlaubt flexible matching eine freiere Interpretation, während precise matching Darstellung, Palette, Komposition und Beleuchtung enger folgt.
Der separate Image-to-Image-Vorgang kann SVG zurückgeben, wenn ein V4.1-Vektormodell gewählt wird. Übergeben Sie ein bestehendes Bild und beschreiben Sie die gewünschte Änderung; strength von 0 bis 1 gibt an, wie weit sich das Ergebnis von der Quelle entfernen darf. Der Vorgang unterstützt PNG-, JPG-, WebP- oder SVG-Eingaben unter 20 MB, bis zu 16 MP und mit Seitenlängen zwischen 256 und 4096 Pixeln. Die V4.1-Parameter zum Stilabgleich werden bei dieser Umwandlung nicht unterstützt; eine Stilreferenz für die Generierung und ein umzuwandelndes Bild haben unterschiedliche Rollen.
Die aktuelle V4.1-Referenz schließt kuratierte Stilnamen, negative_prompt, text_layout, artistic_level und no_text aus. Beschreiben Sie stattdessen das gewünschte positive Layout und den Text, anstatt Parameter aus V3 zu übertragen. Prüfen Sie ein generiertes Logo oder eine Illustration als SVG: Schrift, Silhouetten, Farbflächen und kleine Details müssen in der tatsächlichen Komposition funktionieren. Der praktische Vorteil ist ein bearbeitbarer Vektorausgangspunkt, der einem konkreten Designbriefing folgt, und nicht die Annahme, dass jede zurückgegebene Grafik keine Nachbearbeitung benötigt.
Wählen Sie in Ailoot unter /v1/images/generations diese exakte Modell-ID und übergeben Sie den kreativen Prompt. Ailoots aufgeführtes Profil für Referenzbilder akzeptiert ein optionales input_references-Array mit höchstens einem image_url-Eintrag. Bewahren Sie jeden zurückgegebenen data-Eintrag auf, unabhängig davon, ob die Antwort eine URL oder kodierte Bildinhalte enthält, und speichern Sie die tatsächlichen Bytes mit ihrem zurückgegebenen Inhaltstyp. Halten Sie usage und eine etwaige Medien-task_id zusammen mit der Datei fest und prüfen Sie anschließend Formen, Schrift und Farbflächen im vorgesehenen Design.
Ailoot Ultra · Images POST /v1/images/generations recraft/recraft-v4.1-vector
recraft/recraft-v4.1-vectorStart
Recraft V4.1 Vector generiert bearbeitbare SVG-Logos, Schrift und Illustrationen aus Text mit optionalen Bild- und Stileingaben. Es ist die Standard-Vektorausgabe von V4.1 für Grafiken, die skalierbare Geometrie und spätere Designanpassungen benötigen.
- Zulässige Eingaben
- Text · Bilder
- Ergebnisse
- Bilder
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Images POST /v1/images/generations
- Eingabetypen
text,image- Ausgabetypen
image- Ausgabeformat
- Bilddatei
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits recraft/recraft-v4.1-vector Bedingungen: Verwenden Sie genau diesen Ailoot-Routingselektor. | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits Bedingungen: | Standard— |
Feldn | Typinteger | AnforderungOptional | Werte und Limits Minimum: 1 Maximum: 6 Bedingungen: | Standard— |
Feldaspect_ratio | Typstring | AnforderungOptional | Werte und Limits 1:1, 4:3, 3:4, 16:9, 9:16, auto Bedingungen: | Standard— |
Feldoutput_format | Typstring | AnforderungOptional | Werte und Limits svg Bedingungen: | Standard— |
Feldinput_references | Typarray | AnforderungOptional | Werte und Limits Bedingungen: | Standard— |
Feldquality | Typstring | AnforderungOptional | Werte und Limits auto, low, medium, high, xhigh, max Bedingungen: | Standard— |
Kombinationen von Eingabematerialien
Text zu Bild
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, prompt |
Parameteroptional | Vertragn, aspect_ratio, output_format, input_references, quality |
Parametermaterial_types | Vertragtext, image |
Parameterconditions | VertragVerwenden Sie genau diesen Ailoot-Routingselektor., quality ist ein gängiger dokumentierter Steuerparameter; Anbieter ohne Qualitätseinstellung ignorieren ihn. Eine Qualitätsverbesserung für das jeweilige Modell wird nicht zugesagt. |
Lebenszyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Die tatsächlich zurückgegebene task_id oder der ausgewählte Bibliothekseintrag; operation_id ist eine separate Kennung.
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 Token | TarifstaffelGrundtarif | Prognostizierte Menge— | Abrechnungseinheit— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Token Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Lesen · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Token |
| KonfigurationAusgabebild | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Ausgabebild | Gebühr Ausgabe · Ausgabebild · Schätzung nur zum Vergleich $0.16 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.16 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 · Images
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=json.loads('{"model": "recraft/recraft-v4.1-vector", "prompt": "A portrait of an Asian woman with neon green lights in the background, shallow depth of field."}')
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
# Submit once. Retain the complete result, original identifiers and every response header.
Ergebnisse abrufen und speichern
Ailoot Ultra · Images
Laden Sie jedes zurückgegebene Bild herunter oder speichern Sie seinen Base64-Inhalt
GET /v1/media/tasks/{task_id}GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Alle fertiggestellten Ergebnisse aufbewahren
Speichern Sie jedes fertiggestellte Bild; rufen Sie jede zurückgegebene URL ab oder dekodieren Sie seinen Base64-Inhalt.
Bewahren Sie die vollständige Antwort und die Header, ursprüngliche Kennungen, jede tatsächliche Ausgabe sowie alle Verbrauchs- und Abrechnungsfelder auf. Speichern Sie jedes eindeutige, Ihnen zugeordnete Asset und bewahren Sie jede darauf verweisende Rolle auf.
Wenn die ursprüngliche Antwort geprüft werden muss
Bewahren Sie die ursprüngliche X-Client-Request-ID, Antwort und Header auf. Ein unbekanntes Ergebnis oder ein Ergebnis mit dem Status result_pending_check berechtigt nicht zu einem zweiten Erstellungsauftrag.
Antwortfelder
| Feld | Typ |
|---|---|
Felddata[].url | Typstring |
Felddata[].b64_json | Typstring |
Feldusage | Typobject |
Fehler und nächste Schritte
| Antwort | Bedingung | Nächster Schritt |
|---|---|---|
Antwort400 · invalid_request_error | BedingungEin Pflichtfeld, die Modellauswahl, der Typ oder die Eingabedarstellung ist ungültig. | Nächster SchrittPrüfen Sie die zurückgegebenen Validierungsdetails, bevor Sie eine separate Anfrage vorbereiten. |
Antwort | BedingungDie ursprüngliche Anfrage oder ihr Ergebnis ist unbekannt oder muss geprüft werden. | Nächster SchrittBewahren Sie die ursprünglichen Kennungen und Header auf; lesen Sie nur unterstützte Status- oder Bibliothekseinträge. Senden Sie den Erstellungsauftrag nicht erneut. |
Aliasnamen
Modellaliasnamen
Ailoot Ultra recraft/recraft-v4.1-vector
Aliasnamen für Methodenpfade
Verwenden Sie die oben angezeigten Methodenpfade.
Zugehörige Aufrufer-IDs
FAQ · Recraft: Recraft V4.1 Vector
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/images/generations·recraft/recraft-v4.1-vector:text,image→image- Welche Felder verwendet die Anfrage?
POST /v1/images/generations·recraft/recraft-v4.1-vector:model,prompt,n,aspect_ratio,output_format,input_references,quality- Welche Grenzen gelten?
POST /v1/images/generations·recraft/recraft-v4.1-vector:n.minimum:1;n.maximum:6