Введение
Что делает этот эндпоинт
Отправляет запрос в Recraft V4 и возвращает один исходный SVG.
Важные входные параметры
prompt (до 10,000 символов) описывает дизайн. aspect_ratio выбирает одну из семи форм рабочей области; по умолчанию 1:1.
Что вы получите
Один файл .svg (MIME image/svg+xml), состоящий из контуров.
| Характеристика | Значение |
|---|---|
| Ввод | Текст |
| Вывод | Изображение |
| Формат результата | SVG |
| Длина запроса | До 10,000 символов |
| Соотношения сторон | 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 |
Ключевые возможности и особенности
Знак с лисой и эмблема пекарни — оба можно редактировать
Слева: двухцветный знак с лисой из 18 фигур. Справа: винтажная эмблема пекарни с надписью Rise & Crumb в обрамлении пшеничных колосьев, состоящая из 124 фигур кремового и коричневого цветов. Оба файла открылись в векторном редакторе, где каждый элемент можно было выделить отдельно.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Укажите сюжет, формат (знак логотипа, эмблема, плоская иллюстрация), палитру и надпись для логотипа в кавычках. До 10,000 символов; первое предложение имеет наибольший вес. Не менее 1 символов · Не более 10000 символов |
aspect_ratio | Нет | 1:1 (по умолчанию), 4:3, 3:4, 3:2, 2:3, 16:9 или 9:16. Задаёт пропорции рабочей области SVG; соотношение сторон не влияет на цену. |
Стоимость
$0.096 / SVG
Фиксированная плата за каждый переданный SVG независимо от пропорций рабочей области. Неудачные запросы и пустые результаты не оплачиваются.
Сценарии использования
Поиск идей для логотипа
Создайте несколько знаков для нового продукта или магазина, а затем доработайте лучший вариант в векторном редакторе.
Плоские редакционные иллюстрации
Создавайте вспомогательные иллюстрации для блогов, посадочных страниц и презентаций, которые остаются чёткими на любом экране.
Графика для печати
Создавайте эмблемы, этикетки и графику для упаковки в векторе, чтобы типография могла масштабировать их без потери качества.
Руководство по промптам и практические советы
Опишите задачу
Опишите сюжет, стиль (знак логотипа, эмблема, плоская иллюстрация) и цвета. Любую надпись для логотипа заключите в кавычки.
Выберите пропорции
Выберите
aspect_ratio: 1:1 подходит для знаков и эмблем, 3:2 или 16:9 — для сцен и баннеров.Отредактируйте SVG
Скачайте файл .svg и откройте его в Figma, Illustrator или Inkscape, чтобы настроить цвета, интервалы и буквы.
Введение
Recraft V4 Vector превращает текстовое задание в файл SVG. Recraft разработала V4 для дизайнеров, уделив внимание композиции, цвету и аккуратной геометрии. Этот эндпоинт использует векторный режим модели.
Основные функции и преимущества
Аккуратная геометрия со слоями
Фигуры — это отдельные контуры, поэтому можно перекрасить ухо лисы или передвинуть ленту эмблемы, ничего не перерисовывая.
Соблюдение заданной палитры
В наших тестах модель точно следовала палитрам из запроса, например бирюзовой с коралловым или кремовой с коричневым.
Надписи как часть дизайна
Короткие названия, например Rise & Crumb, рисуются как часть изображения.
Примеры использования
Эскизы фирменного стиля
Попробуйте разные знаки и эмблемы для нового бизнеса, прежде чем передать лучший вариант дизайнеру.
Иллюстрации для сайтов и приложений
Создавайте главные иллюстрации и изображения для пустых состояний интерфейса, которые остаются чёткими на любом экране.
Упаковка и этикетки
Рисуйте графику для этикеток, которую можно увеличивать для печати.
Руководство по запросам и практические советы
Начните с формата
Начните со знака логотипа, эмблемы, значка или плоской иллюстрации, чтобы модель выбрала нужный уровень детализации.
Делайте знаки простыми
Для логотипов запрашивайте плоские или геометрические фигуры и два-три цвета.
Проверяйте надписи
Проверьте орфографию и интервалы, затем при необходимости внесите правки в векторном редакторе.
Быстрый старт 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/v4-vector/text-to-image",
"input": {
"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.
