models

Recraft: Recraft V4.1 Vector

Markdown · JSON

Recraft: Recraft V4.1 Vector

Recraft V4.1 Vector создаёт редактируемые SVG-логотипы, леттеринг и иллюстрации по тексту с необязательными изображениями и стилями. Это стандартная векторная версия V4.1 для графики, которой нужны масштабируемая геометрия и последующая дизайнерская доработка.

О модели

Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.

Recraft V4.1 Vector — стандартная SVG-модель семейства V4.1 от Recraft. Её задача — создавать иллюстрации, логотипы и леттеринг, формы и цвета которых можно менять и использовать как векторные материалы. Она принимает текстовое задание и может работать с изображениями через документированные разработчиком сценарии стиля или image-to-image. Полученный SVG отличается от растрового изображения WebP или PNG семейства V4.1; эту версию нужно определять по векторному формату, а не по обозначению растрового разрешения.

Точный вариант — recraftv4_1_vector, отдельный от recraftv4_1_pro_vector и моделей Utility Vector. Справочник размеров указывает, что все векторные варианты принимают четырнадцать соотношений ширины к высоте и создают SVG без фиксированных пиксельных размеров. Используйте пропорции для нужной композиции, например квадратной иконки или широкого логотипа. Конечный размер отображения затем выбирается в дизайнерском процессе, а не фиксируется растровым выводом 1K.

Разработчик позиционирует V4.1 Vector для выразительной типографики и чистых иллюстраций. Полезное задание указывает объект или слово, характер геометрии, толщину линий, заливки и цветовую систему. Для символа пекарни запросите небольшую графику с одним изогнутым колосом, выразительным силуэтом и тёплыми двухцветными заливками. Явно задавайте важные пространственные отношения вместо общих фраз вроде «современный логотип». Для семейства иконок сохраняйте структурные правила и меняйте названный объект.

Необязательные пользовательские стили могут задавать единое оформление через совместимые сохранённые стили или изображения-референсы. V4.1 поддерживает предпочтительные цвета, желаемый цвет фона, случайный seed и промпты длиной до 10 000 символов; сценарий генерации может вернуть от одного до шести результатов. Стиль-референс необязателен для этой основной модели и должен быть совместим с моделью, использованной при его создании. Используйте чистые референсы из одного визуального мира; точное совпадение цветов референса и вывода не гарантируется. Для генерации со стилем по референсам используйте от одного до десяти изображений PNG, JPG или WebP, суммарно не более 64 МБ и менее 20 МБ каждое. Короткая сторона каждого референса должна быть не менее 256 пикселей, длинная — не более 4 096 пикселей, разрешение — не более 16 мегапикселей. Используйте либо эти референсы, либо совместимый сохранённый стиль, а не оба варианта вместе. При генерации по стилевым референсам гибкое сопоставление допускает более свободную интерпретацию, а точное ближе следует отрисовке, палитре, композиции и освещению.

Отдельная операция image-to-image может вернуть SVG при выборе векторной модели V4.1. Передайте существующее изображение и опишите желаемое изменение, задав strength от 0 до 1 как допустимую степень отклонения результата от источника. Операция поддерживает входные PNG, JPG, WebP или SVG размером менее 20 МБ, до 16 МП и сторонами от 256 до 4096 пикселей. Настройки сопоставления стиля V4.1 не поддерживаются в этой операции преобразования; стилевой референс для генерации и изображение для преобразования выполняют разные роли.

Актуальная документация V4.1 исключает названия готовых стилей, negative_prompt, text_layout, artistic_level и no_text. Опишите желаемую компоновку и текст позитивно вместо переноса настроек из V3. Проверяйте сгенерированный логотип или иллюстрацию как SVG: надписи, силуэты, цветовые области и мелкие детали должны работать в реальной композиции. Практическое преимущество — редактируемая векторная основа по конкретному дизайнерскому заданию, а не предположение, что любой полученный рисунок не требует доработки.

В Ailoot выберите этот точный ID модели в /v1/images/generations и передайте творческий prompt. Указанный профиль изображений-референсов Ailoot принимает необязательный массив input_references, содержащий не более одного элемента image_url. Сохраните каждый полученный элемент data независимо от того, содержит ли ответ URL или закодированное изображение, и сохраните сами байты с полученным типом содержимого. Храните usage и любой task_id медиа вместе с файлом, затем проверьте формы, надписи и цветовые области в целевом дизайне.

Ailoot Ultra · Images POST /v1/images/generations recraft/recraft-v4.1-vector

recraft/recraft-v4.1-vector

Прочее /recraft/recraft-v4.1-vector

Начало

Recraft V4.1 Vector создаёт редактируемые SVG-логотипы, леттеринг и иллюстрации по тексту с необязательными изображениями и стилями. Это стандартная векторная версия V4.1 для графики, которой нужны масштабируемая геометрия и последующая дизайнерская доработка.

Допустимые входные данные
Текст · Картинки
Результаты
Картинки

Доступно в Ailoot · входные данные и методы

Ailoot Ultra · Images POST /v1/images/generations
Входные данные
text, image
Результат
image
Выходной формат
Файл изображения
ПолеТипТребованиеЗначения и ограниченияПо умолчанию
ПолеmodelТипstringТребованиеОбязательноЗначения и ограничения
recraft/recraft-v4.1-vector
Условия: Используйте этот селектор маршрутизации Ailoot в точности.
По умолчанию—
ПолеpromptТипstringТребованиеОбязательноЗначения и ограничения
Условия:
По умолчанию—
ПолеnТипintegerТребованиеНеобязательноЗначения и ограничения
Минимум: 1
Максимум: 6
Условия:
По умолчанию—
Полеaspect_ratioТипstringТребованиеНеобязательноЗначения и ограничения
1:1, 4:3, 3:4, 16:9, 9:16, auto
Условия:
По умолчанию—
Полеoutput_formatТипstringТребованиеНеобязательноЗначения и ограничения
svg
Условия:
По умолчанию—
Полеinput_referencesТипarrayТребованиеНеобязательноЗначения и ограничения
Условия:
По умолчанию—
ПолеqualityТипstringТребованиеНеобязательноЗначения и ограничения
auto, low, medium, high, xhigh, max
Условия:
По умолчанию—
Сочетания входных материалов

Из текста в изображение

Параметры и жизненный цикл метода
ПараметрКонтракт
Параметрcontent_typeКонтрактapplication/json
ПараметрrequiredКонтрактmodel, prompt
ПараметрoptionalКонтрактn, aspect_ratio, output_format, input_references, quality
Параметрmaterial_typesКонтрактtext, image
ПараметрconditionsКонтрактИспользуйте этот селектор маршрутизации Ailoot в точности., Качество — общий документированный параметр; поставщики без настройки качества его игнорируют. Улучшение качества для каждой модели не обещается.

Жизненный цикл: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Фактически возвращённый task_id или выбранная запись библиотеки; operation_id — отдельный идентификатор

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Тарифы

Как рассчитывается итоговая плата

Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом.

Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.

Быстрый режим
Не указано При выборе быстрого режима
Режим flex
Не указано При выборе режима flex
Максимальная интенсивность рассуждений
Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)

Оценочные ставки для сравнения

Цены по конфигурациям

Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.

КонфигурацияШкала ставокПрогноз количестваРасчётная единицаПлата
КонфигурацияБазовые тарифы на токеныШкала ставокБазовая ставкаПрогноз количества—Расчётная единица—Плата
Вход · Входные токены · Оценка только для сравнения — / 1K токенов
Выход · Выходные токены · Оценка только для сравнения — / 1K токенов
Вход · Чтение кэша · Оценка только для сравнения — / 1K токенов
Вход · Запись в кэш · Оценка только для сравнения — / 1K токенов
Вход · Запись в кэш, 1 час · Оценка только для сравнения — / 1K токенов
Конфигурациявыходное изображениеШкала ставок—Прогноз количества—Расчётная единицаза выходное изображениеПлата
Выход · выходное изображение · Оценка только для сравнения $0.16 за выходное изображение
КонфигурацияОриентировочная стоимость генерацииШкала ставок—Прогноз количестваОценка для одной генерацииРасчётная единица—Плата
Выход · Оценочная стоимость генерации · Оценка только для сравнения $0.16 оценка до генерации

Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации.

Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →

Примеры запросов

Ailoot Ultra · Images

curl · создать один раз и сохранить полный результат
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "recraft/recraft-v4.1-vector", "prompt": "A portrait of an Asian woman with neon green lights in the background, shallow depth of field."}')

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.

Получить и сохранить результаты

Ailoot Ultra · Images

Загрузите каждое полученное изображение или сохраните его содержимое Base64

  • GET /v1/media/tasks/{task_id}
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Сохраняйте все готовые результаты

Сохраните каждое готовое изображение; загрузите содержимое по каждому полученному URL или декодируйте его содержимое Base64.

Сохраните полный ответ и заголовки, исходные идентификаторы, каждый фактический результат и все поля использования и учёта. Сохраните каждый уникальный ресурс, принадлежащий Ailoot, и каждую роль, которая на него ссылается.

Если нужно проверить исходный ответ

Сохраните исходный X-Client-Request-ID, ответ и заголовки. Неизвестный результат или result_pending_check не разрешает повторное создание.

Поля ответа
ПолеТип
Полеdata[].urlТипstring
Полеdata[].b64_jsonТипstring
ПолеusageТипobject
Ошибки и дальнейшие шаги
ОтветУсловиеСледующий шаг
Ответ400 · invalid_request_errorУсловиеОбязательное поле, селектор модели, тип или представление входных данных недопустимы.Следующий шагИзучите возвращённые сведения о проверке данных перед подготовкой отдельного запроса.
ОтветУсловиеИсходный запрос или результат неизвестен либо требует проверки.Следующий шагСохраните исходные идентификаторы и заголовки; читайте только поддерживаемые записи статуса или библиотеки. Не отправляйте запрос на создание повторно.

Псевдонимы

Псевдонимы моделей

Ailoot Ultra recraft/recraft-v4.1-vector

Псевдонимы путей метода

Используйте пути методов, указанные выше.

Связанные ID для вызова

recraft/recraft-v4.1-vector

FAQ · Recraft: Recraft V4.1 Vector
Какие входные данные и результаты доступны?

POST /v1/images/generations · recraft/recraft-v4.1-vector: text, image → image

Какие поля использует запрос?

POST /v1/images/generations · recraft/recraft-v4.1-vector: model, prompt, n, aspect_ratio, output_format, input_references, quality

Какие ограничения действуют?

POST /v1/images/generations · recraft/recraft-v4.1-vector: n.minimum: 1; n.maximum: 6

Подробнее

Подключите Ailoot к Claude Code, OpenCode, Hermes или своему приложению.

Компания и портфель её проектов

Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно.

Покупайте токены со скидкой.

Скидка по подписке для регулярной работы. Промокоды — до 50% на покупку токенов.

Подписка
Выберите тариф со скидкой для своих регулярных запросов.
Промокод до 50%
Введите код при покупке. Цена пересчитается с учётом действующей акции.
Расходы в истории
Модель, токены и сумма сохраняются для каждого запроса.

Выбрать подписку · Посмотреть цены моделей

Подключайте API к продукту, который вы продаёте.

SaaS, приложения и боты — по оферте и лицензионному договору Ailoot. Для перепродажи запросите реселлерскую лицензию.

Коммерческое приложение
Встраивайте генерацию текста, картинок, видео и звука в платные функции своего сервиса.
Лицензия для реселлера
Пришлите описание проекта и схему доступа. Запросите письменные условия использования и перепродажи.
Документы на сайте
Оферта, лицензионный договор и политика обработки данных доступны до подключения.

Запросить реселлерскую лицензию · Оферта и лицензионный договор