Recraft: Recraft V4.1 Pro Vector
Recraft V4.1 Pro Vector создаёт редактируемую SVG-графику для логотипов, леттеринга и детальных иллюстраций. Это векторная версия Pro семейства V4.1, объединяющая текстовые промпты с необязательными изображениями и стилями и сохраняющая векторный результат.
О модели
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
Recraft V4.1 Pro Vector — версия Pro для SVG из семейства генерации изображений V4.1 от Recraft. Она предназначена для работ, где результат должен остаться редактируемой векторной графикой: логотипа, типографической концепции, иконки или иллюстрации. В презентации V4.1 разработчик подчёркивает продуманную композицию и иллюстрацию, а документация конкретной модели отделяет этот вариант от стандартных версий Vector, растровой Pro и Utility. Итоговое изображение — SVG, а не растровый экспорт высокого разрешения.
Код модели разработчика — recraftv4_1_pro_vector. Векторный вывод не имеет фиксированного размера в пикселях; справочник размеров принимает четырнадцать соотношений ширины к высоте для векторных моделей и не принимает точные пиксельные размеры. Поэтому растровые настройки Pro 2K не определяют разрешение SVG этой версии. Задайте нужные пропорции и назначение графики. Для логотипа важны читаемый силуэт и редактируемые цветовые области, которые можно доработать в дизайнерском процессе.
Модель поддерживает генерацию по тексту и необязательные референсы пользовательского стиля. Документированный лимит промпта — 10 000 символов. Предпочтительные цвета, желаемый цвет фона и случайный seed могут направлять генерацию; сценарий допускает от одного до шести результатов. Совместимый сохранённый стиль или изображения-референсы могут задать визуальный язык; стиль должен соответствовать модели, для которой был создан. Основная линия V4.1 не требует стилевого референса в каждом запросе, в отличие от отдельного семейства V4 Styles. Для генерации со стилем по референсам используйте от одного до десяти изображений PNG, JPG или WebP, суммарно не более 64 МБ и менее 20 МБ каждое. Короткая сторона каждого референса должна быть не менее 256 пикселей, длинная — не более 4 096 пикселей, разрешение — не более 16 мегапикселей. Используйте либо эти референсы, либо совместимый сохранённый стиль, а не оба варианта вместе. При генерации по стилевым референсам гибкое сопоставление допускает более свободную интерпретацию, а точное ближе следует отрисовке, палитре, композиции и освещению.
Полезное задание на векторную графику задаёт тип рисунка, логику форм, палитру, характер линий и расположение до декоративных деталей. Для эмблемы садового магазина запросите один силуэт ростка, округлую геометрию, два плоских цвета и центральную компоновку. Для леттеринга включите точное слово и опишите его иерархию и форму, затем проверьте в полученном SVG читаемость внутрибуквенных просветов, интервалы и ясность в малом размере. Векторные примеры разработчика показывают выразительную типографику и иллюстрацию; они не гарантируют, что все сгенерированные буквы и контуры уже готовы к использованию.
Recraft документирует отдельный сценарий image-to-image для растровых и векторных моделей V4.1. Он объединяет существующее изображение и промпт, а strength от 0 до 1 регулирует степень отклонения нового результата от оригинала. Низкое значение удерживает результат ближе к источнику, высокое допускает больше изменений. Эта операция не принимает настройки пользовательского стиля V4/V4.1, поэтому преобразование исходного изображения и генерацию по стилевым референсам нужно готовить как разные сценарии. Входное изображение может быть PNG, JPG, WebP или SVG в пределах документированных ограничений. Для image-to-image передайте PNG, JPG, WebP или SVG размером менее 20 МБ, разрешением не более 16 мегапикселей и обеими сторонами от 256 до 4 096 пикселей.
V4.1 не поддерживает названия готовых стилей и настройки negative_prompt, text_layout, artistic_level или no_text. Укажите желаемое расположение и надписи в позитивном задании, а не полагайтесь на старые механизмы V3. Для детального брендового материала используйте SVG как рабочий файл, проверьте геометрию и при необходимости скорректируйте цвета или формы до размещения в конечном макете. Эта версия Pro Vector сохраняет свою отдельную идентичность; она не взаимозаменяема со стандартными растровыми вариантами или Utility только потому, что они носят имя V4.1.
В Ailoot выберите этот точный ID модели в /v1/images/generations и передайте творческий prompt. Сохраните каждый полученный элемент data независимо от того, содержит ли ответ URL или закодированное изображение, и сохраните сами байты с полученным типом содержимого. Храните usage и любой task_id медиа вместе с файлом, затем проверьте формы, надписи и цветовые области в целевом дизайне.
Ailoot Ultra · Images POST /v1/images/generations recraft/recraft-v4.1-pro-vector
recraft/recraft-v4.1-pro-vector
recraft/recraft-v4.1-pro-vectorНачало
Recraft V4.1 Pro Vector создаёт редактируемую SVG-графику для логотипов, леттеринга и детальных иллюстраций. Это векторная версия Pro семейства V4.1, объединяющая текстовые промпты с необязательными изображениями и стилями и сохраняющая векторный результат.
- Допустимые входные данные
- Текст · Картинки
- Результаты
- Картинки
Доступно в Ailoot · входные данные и методы
Ailoot Ultra · Images POST /v1/images/generations
- Входные данные
text,image- Результат
image- Выходной формат
- Файл изображения
| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения recraft/recraft-v4.1-pro-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.6 за выходное изображение |
| КонфигурацияОриентировочная стоимость генерации | Шкала ставок— | Прогноз количестваОценка для одной генерации | Расчётная единица— | Плата Выход · Оценочная стоимость генерации · Оценка только для сравнения $0.6 оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации. |
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-pro-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-pro-vector
Псевдонимы путей метода
Используйте пути методов, указанные выше.
Связанные ID для вызова
FAQ · Recraft: Recraft V4.1 Pro Vector
- Какие входные данные и результаты доступны?
POST /v1/images/generations·recraft/recraft-v4.1-pro-vector:text,image→image- Какие поля использует запрос?
POST /v1/images/generations·recraft/recraft-v4.1-pro-vector:model,prompt,n,aspect_ratio,output_format,input_references,quality- Какие ограничения действуют?
POST /v1/images/generations·recraft/recraft-v4.1-pro-vector:n.minimum:1;n.maximum:6