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 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
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/assetsGET /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 для вызова
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