О модели Recraft 20B SVG
SVG-иконки и иллюстрации в 21 векторном стиле.
Вызывайте его по имени модели recraft/20b-svg/text-to-image через POST /jobs/createTask, от 0,0528 $.
Введение
Вместо описания стиля словами вы выбираете его из списка 21 именованного вида.
Ключевые возможности
21 именованный стиль
Стили иконок включают outline, broken_line, colored_outline, colored_shapes, colored_shapes_gradient, doodle_fill, doodle_offset_fill, offset_fill, outline_gradient и uneven_fill.
Быстрый результат
В наших запусках каждый занимал около 11 секунд, поэтому пакетная работа с иконками практична.
Небольшие файлы
Иконки возвращались размером 20–25 КБ.
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
style | Нет | Готовый стиль или жанр. vector_illustration · vector_illustration/cartoon · vector_illustration/doodle_line_art · vector_illustration/engraving · vector_illustration/flat_2 · vector_illustration/kawaii · vector_illustration/line_art · vector_illustration/line_circuit · vector_illustration/linocut · vector_illustration/seamless · icon · icon/broken_line · icon/colored_outline · icon/colored_shapes · icon/colored_shapes_gradient · icon/doodle_fill · icon/doodle_offset_fill · icon/offset_fill · icon/outline · icon/outline_gradient · icon/uneven_fill · По умолчанию: vector_illustration |
prompt | Да | Опишите, что хотите сделать. |
aspect_ratio | Нет | Форма кадра: широкая, квадратная или вертикальная. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · По умолчанию: 1:1 |
Цены
Цены указаны в USD. API использует отдельный баланс в долларах США. Кредиты сайта нельзя тратить в API или переводить на баланс API. Перевод с баланса API в кредиты сайта также недоступен. При принятии задачи мы резервируем максимальную сумму расчёта на балансе API. После завершения списываем плату за фактическое использование, не превышая резерв, и освобождаем остаток. Если задача завершается ошибкой, резерв освобождается.
| Вариант | USD за изображение |
|---|---|
| Стандарт | 0,0528 $ |
До запуска отправьте то же тело запроса в POST /jobs/quote, чтобы узнать ожидаемую и максимальную стоимость в USD. Расчёт не запускает задачу и не списывает деньги.
Сценарии использования
Библиотеки иконок для продуктов
Создайте согласованный набор для навигации, настроек и списков функций.
Наклейки и штампы
Используйте линогравюру, гравировку или линейный рисунок для печати и режущих плоттеров.
Руководство по промптам и советы
Одна иконка — один объект
Короткие промпты, например гора с восходящим солнцем, дают более чистые иконки, чем длинные описания сцен.
Фиксируйте стиль для набора
Используйте одно и то же значение style для всех иконок набора.
Не добавляйте текст в иконки
Модель слабо справляется с надписями; добавляйте подписи в инструменте дизайна.
Быстрый старт API
Вызов API Recraft 20B SVG в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow-. Вызовы используют отдельный баланс в долларах США.
- Отправьте запрос. Отправьте POST /jobs/createTask с model recraft/20b-svg/text-to-image и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
- Получите результат. Опрашивайте GET /jobs/recordInfo по ID задачи или передайте callBackUrl — мы отправим результат туда. Когда задача выполнится, скачайте файлы по ссылкам.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "recraft/20b-svg/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"style": "vector_illustration",
"aspect_ratio": "1:1"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Замените промпт и ссылки на свои. Справка по ответу, опросу статуса и callback есть на вкладке API.
Вопросы об API Recraft 20B SVG
Сколько стоит API Recraft 20B SVG?
Recraft 20B SVG стоит 0,0528 $ за изображение. API использует отдельный баланс в долларах США. Кредиты сайта нельзя тратить в API или переводить на баланс API. Перевод с баланса API в кредиты сайта также недоступен. При принятии задачи мы резервируем максимальную сумму расчёта на балансе API. После завершения списываем плату за фактическое использование, не превышая резерв, и освобождаем остаток. Если задача завершается ошибкой, резерв освобождается.
Какое имя модели у Recraft 20B SVG в API?
Укажите recraft/20b-svg/text-to-image — Генератор SVG в поле model запроса POST /jobs/createTask.
Какой стиль выбрать для иконок интерфейса?
icon/outline создаёт линейные иконки с одинаковой толщиной штриха, icon/colored_outline добавляет мягкие заливки внутри контуров, а icon/colored_shapes использует сплошные фигуры без обводки. Выберите один стиль для всего набора, чтобы иконки сочетались друг с другом.
Это действительно векторные файлы?
Да. Наши результаты содержали от 13 до 90 элементов контура и никаких других рисующих элементов. SVG со встроенными растровыми изображениями отклоняются на этапе выдачи.
Какие ограничения у API Recraft 20B SVG?
Соотношения сторон: 1:1 · 16:9 · 9:16 · 4:3 · 3:4; Длина промпта (символов): 1,000. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать Recraft 20B SVG без кода?
Запускайте Recraft 20B SVG в Playground с баланса API в USD без API-ключа. Каждый запуск сохраняется в истории разработчика с соответствующим кодом.