Введение
Что делает этот эндпоинт
Вызывает Recraft 20B в режиме SVG и возвращает один векторный файл.
Важные входные параметры
prompt задаёт объект. style выбирает один из 21 стиля (по умолчанию vector_illustration). aspect_ratio принимает значения 1:1, 16:9, 9:16, 4:3 или 3:4.
Что вы получите
Один файл .svg (MIME image/svg+xml).
| Характеристика | Значение |
|---|---|
| Ввод | Текст |
| Вывод | Изображение |
| Выходной формат | SVG |
| Стили | 21 (10 для иконок, 11 для иллюстраций) |
| Соотношения сторон | 1:1, 16:9, 9:16, 4:3, 3:4 |
Ключевые возможности и особенности
Одна модель, два стиля иконок
Слева: кофейная чашка в стиле icon/colored_outline, 14 контуров с коричневой обводкой и мягкими заливками. Справа: туристическая иконка горы и солнца в стиле icon/outline, 13 контуров только из линий. Один стиль для всего набора помогает получить сочетающиеся иконки.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Один объект воспринимается лучше, особенно в иконках: дымящаяся кофейная чашка или гора на фоне восходящего солнца. При необходимости укажите цвета словами. Не менее 1 символов · Не более 1000 символов |
style | Нет | Десять стилей иконок (outline, |
aspect_ratio | Нет | 1:1 (по умолчанию) для иконок; 16:9, 9:16, 4:3 или 3:4 для баннеров и сцен. Задаёт форму холста SVG без доплаты. |
Стоимость
$0.053 / SVG
За каждую выданную иконку или иллюстрацию взимается фиксированная плата независимо от стиля и соотношения сторон. Если генерация завершилась ошибкой, плата не взимается.
Сценарии использования
Наборы иконок для приложений и сайтов
Создавайте иконки для меню, функций и пустых состояний в одном стиле, а затем меняйте цвета под свой интерфейс.
Быстрая графика для блогов и соцсетей
За несколько секунд создайте небольшую иллюстрацию в мультяшном стиле или kawaii для публикации или рассылки.
Творческие проекты и печать
Используйте линейный рисунок, гравюру или линогравюру для наклеек, штампов, режущих плоттеров и печатных открыток.
Руководство по промптам и практические советы
Выберите стиль
Выберите стиль icon/* для иконок интерфейса или vector_illustration/* для сцен. По умолчанию используется
vector_illustration.Опишите один объект
Иконки лучше получаются с одним объектом, например с дымящейся кофейной чашкой или горой на фоне восходящего солнца.
Скачайте SVG
Периодически проверяйте статус задачи, скачайте файл .svg и добавьте его в инструмент дизайна или код проекта.
Введение
Recraft 20B SVG создаёт векторные иконки и иллюстрации быстро и недорого. Вместо описания стиля словами выберите его из списка из 21 именованного варианта.
Основные возможности и преимущества
21 именованный стиль
Стили иконок включают outline, broken_line, colored_outline, colored_shapes, colored_shapes_gradient, doodle_fill, doodle_offset_fill, offset_fill, outline_gradient и uneven_fill. Стили иллюстраций включают cartoon, doodle_line_art, engraving, flat_2, kawaii, line_art, line_circuit, linocut и seamless.
Быстрая генерация
Наши запуски занимали около 11 секунд каждый, что удобно для пакетного создания иконок.
Небольшие файлы
Размер полученных иконок составлял 20–25 KB.
Сценарии использования
Библиотеки иконок для продуктов
Создайте единый набор для навигации, настроек и списков функций.
Иллюстрации для контента
Добавьте мультяшное изображение или картинку kawaii в статью, рассылку или слайд.
Наклейки и штампы
Используйте линогравюру, гравюру или линейный рисунок для печати и режущих плоттеров.
Руководство по промптам и практические советы
Один объект на иконку
Короткие промпты, например гора на фоне восходящего солнца, дают более аккуратные иконки, чем длинные описания сцен.
Единый стиль для набора
Используйте одно и то же значение style для каждой иконки в наборе.
Не добавляйте текст в иконки
Модель плохо справляется с надписями. Добавьте подписи в инструменте дизайна.
Быстрый старт 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"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.
