Wprowadzenie
Co robi ten endpoint
Wywołuje Recraft 20B w trybie SVG i zwraca jeden plik wektorowy.
Ważne parametry wejściowe
prompt określa temat. style wybiera jeden z 21 stylów (domyślnie vector_illustration). aspect_ratio przyjmuje 1:1, 16:9, 9:16, 4:3 lub 3:4.
Co otrzymasz
Jeden plik .svg (MIME image/svg+xml).
| Pole | Wartość |
|---|---|
| Wejście | Tekst |
| Wyjście | Obraz |
| Format wyjściowy | SVG |
| Style | 21 (10 stylów ikon, 11 stylów ilustracji) |
| Proporcje obrazu | 1:1, 16:9, 9:16, 4:3, 3:4 |
Najważniejsze funkcje
Jeden model, dwa wyglądy ikon
Po lewej: filiżanka kawy w stylu icon/colored_outline, 14 ścieżek z brązowym konturem i delikatnymi wypełnieniami. Po prawej: podróżnicza ikona góry i słońca w stylu icon/outline, 13 ścieżek z samych linii. Jeden styl w całym zestawie zapewnia spójność ikon.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
prompt | Tak | Jeden temat jest czytelniejszy, szczególnie w ikonach: parująca filiżanka kawy lub góra ze wschodzącym słońcem. Jeśli chcesz określone kolory, opisz je słowami. od 1 znaków · do 1000 znaków |
style | Nie | Dziesięć stylów ikon (outline, |
aspect_ratio | Nie | 1:1 (domyślnie) do ikon; 16:9, 9:16, 4:3 lub 3:4 do banerów i scen. Określa kształt obszaru roboczego SVG bez dodatkowych opłat. |
Cennik
$0.053 / SVG
Za każdą dostarczoną ikonę lub ilustrację naliczana jest jedna stała opłata, niezależnie od stylu i proporcji. Jeśli generowanie się nie powiedzie, opłata nie jest naliczana.
Zastosowania
Zestawy ikon do aplikacji i stron
Generuj ikony do menu, funkcji i pustych widoków w jednym stylu, a potem zmień ich kolory, aby pasowały do interfejsu.
Szybkie grafiki na blog i do mediów społecznościowych
Stwórz w kilka sekund niewielką ilustrację w stylu kreskówkowym lub kawaii do wpisu albo newslettera.
Projekty rękodzielnicze i druk
Wykorzystaj rysunek liniowy, grawiurę lub linoryt do naklejek, pieczątek, ploterów tnących i drukowanych kartek.
Wskazówki
Wybierz styl
Wybierz styl icon/* do ikon interfejsu lub vector_illustration/* do scen. Wartość domyślna to
vector_illustration.Opisz jeden temat
Ikony najlepiej wychodzą z jednym obiektem, na przykład parującą filiżanką kawy lub górą ze wschodzącym słońcem.
Pobierz SVG
Sprawdzaj okresowo stan zadania, pobierz plik .svg i dodaj go do narzędzia projektowego lub kodu.
Wprowadzenie
Recraft 20B SVG generuje ikony i ilustracje wektorowe szybko i tanio. Zamiast opisywać styl słowami, wybierz go z listy 21 nazwanych stylów.
Główne funkcje i zalety
21 nazwanych stylów
Style ikon obejmują outline, broken_line, colored_outline, colored_shapes, colored_shapes_gradient, doodle_fill, doodle_offset_fill, offset_fill, outline_gradient i uneven_fill. Style ilustracji obejmują cartoon, doodle_line_art, engraving, flat_2, kawaii, line_art, line_circuit, linocut i seamless.
Szybkie wyniki
Nasze próby trwały około 11 sekund każda, co ułatwia tworzenie ikon seriami.
Małe pliki
Wygenerowane ikony miały rozmiar 20–25 KB.
Zastosowania
Biblioteki ikon do produktów
Wygeneruj spójny zestaw do nawigacji, ustawień i list funkcji.
Ilustracje do treści
Dodaj ilustrację kreskówkową lub kawaii do artykułu, newslettera albo slajdu.
Naklejki i pieczątki
Wykorzystaj linoryt, grawiurę lub rysunek liniowy do druku i ploterów tnących.
Pisanie promptów i praktyczne wskazówki
Jeden obiekt na ikonę
Krótkie prompty, takie jak góra ze wschodzącym słońcem, dają czytelniejsze ikony niż długie opisy scen.
Jeden styl dla całego zestawu
Użyj tej samej wartości style dla każdej ikony w zestawie.
Bez tekstu w ikonach
Model słabo radzi sobie z liternictwem. Dodaj podpisy w narzędziu projektowym.
Szybki start z API
# 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"
Uwierzytelnianie, pełny schemat, odpytywanie i obsługę błędów opisuje dokumentacja API.
