Einführung
Was dieser Endpoint macht
Ruft Recraft 20B im SVG-Modus auf und liefert eine Vektordatei zurück.
Wichtige Eingaben
prompt beschreibt das Motiv. style wählt einen von 21 Stilen (Standard: vector_illustration). aspect_ratio ist 1:1, 16:9, 9:16, 4:3 oder 3:4.
Das erhalten Sie zurück
Eine .svg-Datei (MIME image/svg+xml).
| Feld | Wert |
|---|---|
| Eingabe | Text |
| Ausgabe | Bild |
| Stile | 21 (10 Icon-, 11 Illustrationsstile) |
| Seitenverhältnisse | 1:1, 16:9, 9:16, 4:3, 3:4 |
Wichtige Funktionen und Highlights
Ein Modell, zwei Icon-Looks
Links: eine Kaffeetasse in icon/colored_outline, 14 Pfade mit braunen Konturen und dezenten Füllfarben. Rechts: ein Reise-Icon mit Berg und Sonne in icon/outline, 13 reine Linienpfade. Ein einheitlicher Stil sorgt für zusammenpassende Icons im ganzen Set.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Ein einzelnes Motiv wirkt am klarsten, besonders bei Icons: eine dampfende Kaffeetasse oder ein Berg mit aufgehender Sonne. Nennen Sie bei Bedarf gewünschte Farben. mindestens 1 Zeichen · höchstens 1000 Zeichen |
style | Nein | Zehn Icon-Stile (outline, |
aspect_ratio | Nein | 1:1 (Standard) für Icons; 16:9, 9:16, 4:3 oder 3:4 für Banner und Szenen. Legt die Form der SVG-Zeichenfläche ohne Aufpreis fest. |
Preis
$0.053 / SVG
Für jedes ausgelieferte Icon und jede Illustration gilt ein fester Preis, unabhängig von Stil und Seitenverhältnis. Schlägt die Generierung fehl, fallen keine Kosten an.
Anwendungsfälle
Icon-Sets für Apps und Websites
Erstellen Sie Icons für Menüs, Funktionen und leere Ansichten in einem einheitlichen Stil. Passen Sie anschließend die Farben an Ihre Oberfläche an.
Schnelle Grafiken für Blogs und soziale Medien
Erstellen Sie in Sekunden eine kleine Illustration im Cartoon- oder Kawaii-Stil für einen Beitrag oder Newsletter.
Bastel- und Druckprojekte
Nutzen Sie Linienzeichnungen, Gravur- oder Linolschnittstile für Aufkleber, Stempel, Schneideplotter und gedruckte Karten.
Prompt-Leitfaden und Praxistipps
Stil auswählen
Wählen Sie für UI-Icons einen icon/-Stil und für Szenen einen vector_illustration/-Stil. Die Standardeinstellung ist
vector_illustration.Ein Motiv beschreiben
Icons gelingen am besten mit einem einzelnen Objekt, etwa einer dampfenden Kaffeetasse oder einem Berg mit aufgehender Sonne.
SVG herunterladen
Fragen Sie den Aufgabenstatus regelmäßig ab, laden Sie die .svg-Datei herunter und fügen Sie sie in Ihr Designwerkzeug oder Ihre Codebasis ein.
Einführung
Recraft 20B SVG erstellt Vektor-Icons und Illustrationen schnell und preiswert. Statt einen Stil mit Worten zu beschreiben, wählen Sie ihn aus einer Liste mit 21 benannten Stilen.
Wichtige Funktionen und Vorteile
21 wählbare Stile
Zu den Icon-Stilen gehören outline, broken_line, colored_outline, colored_shapes, colored_shapes_gradient, doodle_fill, doodle_offset_fill, offset_fill, outline_gradient und uneven_fill. Zu den Illustrationsstilen gehören cartoon, doodle_line_art, engraving, flat_2, kawaii, line_art, line_circuit, linocut und seamless.
Schnelle Ergebnisse
Unsere Durchläufe dauerten jeweils etwa 11 Sekunden. Damit lassen sich auch größere Icon-Mengen gut erstellen.
Kleine Dateien
Die erzeugten Icons waren 20–25 KB groß.
Einsatzbereiche
Icon-Bibliotheken für Produkte
Erstellen Sie ein einheitliches Set für Navigation, Einstellungen und Funktionslisten.
Illustrationen für Inhalte
Ergänzen Sie Artikel, Newsletter oder Präsentationsfolien um ein Cartoon- oder Kawaii-Bild.
Aufkleber und Stempel
Nutzen Sie Linolschnitt, Gravur oder Linienzeichnungen für Druck und Schneideplotter.
Prompt-Leitfaden und Praxistipps
Ein Objekt pro Icon
Kurze Beschreibungen wie ein Berg mit aufgehender Sonne ergeben klarere Icons als lange Szenenbeschreibungen.
Ein Stil für das ganze Set
Verwenden Sie für jedes Icon im Set denselben style-Wert.
Keine Schrift im Icon
Das Modell hat Schwächen bei Schrift. Fügen Sie Beschriftungen in Ihrem Designwerkzeug hinzu.
API-Schnellstart
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "recraft/20b-svg/text-to-image",
"input": {
"style": "vector_illustration",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Authentifizierung, vollständiges Schema, Polling und Fehlerbehandlung stehen in der API-Referenz.
