Recraft: Recraft V4.1 Vector
Recraft V4.1 Vector erzeugt aus Text bearbeitbare SVG-Logos, Schriftgestaltungen und Illustrationen, optional mit 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 Schriftgestaltungen, deren Formen und Farben verändert und die als Vektorgrafiken verwendet werden können. Es akzeptiert ein Textbriefing und kann Bildeingaben über die vom Hersteller dokumentierten Stil- oder Bild-zu-Bild-Abläufe verarbeiten. Das resultierende SVG ist ein anderes Arbeitsergebnis als ein WebP- oder PNG-Rasterbild von V4.1; kennzeichnen Sie diese Ausgabe daher durch das Vektorformat und nicht durch eine Rasterauflösungsangabe.
Die exakte Variante lautet recraftv4_1_vector, getrennt 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 Pixelabmessungen. Legen Sie damit die gewünschte Komposition fest, etwa ein quadratisches Icon oder ein breites Logo. Die spätere Anzeigegröße kann dann im Designablauf gewählt werden, statt durch eine 1K-Rasterausgabe festgelegt zu sein.
Der Hersteller positioniert V4.1 Vector für ausdrucksstarke Typografie und klare Illustration. Ein hilfreiches Briefing nennt Objekt oder Wort, geometrischen Charakter, Linienstärke, Flächenbehandlung und Farbsystem. Fordern Sie für ein Bäckereisymbol eine kleine Grafik mit einer gebogenen Getreideähre, kräftiger Silhouette und warmen zweifarbigen Flächen an. Benennen Sie wichtige räumliche Beziehungen ausdrücklich, statt sich auf eine allgemeine Formulierung wie „modernes Logo“ zu verlassen. Halten Sie bei einer Iconfamilie die Strukturregeln 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 Zufallsseed und Prompts mit bis zu 10,000 Zeichen; der Generierungsablauf kann ein bis sechs Ausgaben zurückgeben. Ein Referenzstil ist bei diesem Hauptlinienmodell optional und muss mit dem Modell kompatibel sein, mit dem er erstellt wurde. Verwenden Sie klare Referenzen aus derselben Bildwelt; exakte Farbgleichheit zwischen Referenz und Ausgabe ist nicht garantiert. Verwenden Sie für die Generierung mit Stilreferenzen ein bis zehn PNG-, JPG- oder WebP-Bilder, insgesamt höchstens 64 MB und jeweils unter 20 MB. Jede Referenz muss an der kürzesten Seite mindestens 256 Pixel, an der längsten höchstens 4,096 Pixel und insgesamt höchstens 16 Megapixel aufweisen. Verwenden Sie entweder diese Referenzen oder einen kompatiblen gespeicherten Stil, nicht beides. Bei der Generierung mit Stilreferenzen erlaubt flexible Abgleichung eine freiere Interpretation, während präzise Abgleichung Darstellung, Palette, Komposition und Beleuchtung enger folgt.
Die separate Bild-zu-Bild-Operation kann SVG zurückgeben, wenn ein V4.1-Vektormodell gewählt wird. Stellen Sie ein vorhandenes Bild bereit und beschreiben Sie die gewünschte Änderung; strength von 0 bis 1 gibt an, wie weit sich das Ergebnis von der Quelle entfernen darf. Die Operation unterstützt PNG-, JPG-, WebP- oder SVG-Eingaben unter 20 MB, mit bis zu 16 MP und Seiten zwischen 256 und 4096 Pixeln. Einstellungen zum V4.1-Stilabgleich werden in dieser Umwandlungsoperation 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, ohne Einstellungen aus V3 zu übertragen. Prüfen Sie ein erzeugtes 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, nicht die Annahme, dass jede zurückgegebene Grafik ohne Nachbearbeitung auskommt.
Wählen Sie über Ailoot diese exakte Modell-ID in /v1/images/generations und geben Sie den kreativen Prompt an. Ailoots aufgeführtes Referenzbildprofil akzeptiert ein optionales Array input_references mit höchstens einem image_url-Eintrag. Bewahren Sie jeden zurückgegebenen data-Eintrag auf, unabhängig davon, ob die Antwort eine URL oder codierte Bildinhalte enthält, und speichern Sie die tatsächlichen Bytes mit ihrem zurückgegebenen Inhaltstyp. Halten Sie usage und jede Medien-task_id 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-vectorEinstieg
Recraft V4.1 Vector erzeugt aus Text bearbeitbare SVG-Logos, Schriftgestaltungen und Illustrationen, optional mit 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
- Eingabe
text,image- Ausgabe
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 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.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, die ursprünglichen Kennungen, jede tatsächliche Ausgabe und alle Verbrauchs- und Abrechnungsfelder auf. Speichern Sie jedes eindeutige, Ihnen zugeordnete Asset und erhalten Sie jede Rolle, die darauf verweist.
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