Recraft: Recraft V4 Styles Vector
Recraft V4 Styles Vector создаёт редактируемую SVG-графику по текстовому заданию и обязательному визуальному стилю. Модель подходит для согласованных иконок, логотипов и иллюстраций, в которых линии, палитра и отрисовка должны следовать одному направлению референсов.
О модели
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
Recraft V4 Styles Vector — модель, создающая SVG в отдельной линейке Recraft для генерации в едином стиле. Она превращает текстовое задание в новую векторную графику, используя переданный стиль-референс для отрисовки, цветовой логики и общего вида. Модель полезна для согласованных наборов иконок, брендовых иллюстраций и графических систем, где объекты меняются, а оформление должно оставаться узнаваемым. Версия Vector возвращает редактируемую графику, а не растровую фотографию.
Разработчик обозначает эту версию как recraftv4_styles_vector. Её вывод всегда SVG; растровые настройки image_format не превращают его в WebP или PNG. Каждый векторный вариант принимает четырнадцать документированных соотношений ширины к высоте вместо точных размеров в пикселях. SVG не имеет фиксированного пиксельного разрешения, поэтому вывод стандартной растровой модели 1K не задаёт архитектурный размер этой версии. При подготовке задания выберите нужную форму графики и её назначение для малого или большого размера отображения.
Стиль обязателен для каждой генерации. Используйте от одного до десяти референсов PNG, JPG или WebP либо совместимый сохранённый стиль вместо новых референсов. Разработчик отклоняет запрос, сочетающий идентификатор сохранённого стиля с изображениями-референсами стиля. Документированный лимит — суммарно 64 МБ и менее 20 МБ на файл. Одна ясная иконка или иллюстрация может задать оформление; несколько референсов полезны, когда толщина линий, углы, логика заливок и палитра уже принадлежат единой визуальной системе. Короткая сторона каждого референса должна быть не менее 256 пикселей, длинная — не более 4 096 пикселей, общее разрешение — не более 16 мегапикселей.
Гибкое сопоставление используется по умолчанию и свободнее интерпретирует референс, а точное ближе следует его отрисовке, цветам, композиции и освещению. Для векторной системы определите в промпте тип графики, силуэт, количество объектов и компоновку. Для набора навигационных иконок задайте жирные округлые контуры, один объект по центру каждого изображения и двухцветную палитру. Сохраняйте тот же стиль-референс и меняйте объект в каждом задании вместо смешивания несвязанных референсов ради разнообразия.
Документация генерации допускает промпты длиной до 10 000 символов, от одного до шести результатов, случайный seed, предпочтительные цвета и желаемый цвет фона. Негативные промпты, названия готовых стилей и старый параметр text_layout не поддерживаются. Эта версия Styles также не предоставляет image-to-image или inpainting: изображение-референс задаёт визуальный язык, а не область для удаления или существующую графику, которую нужно сохранить без изменений. Структурные инструкции в позитивном задании должны описывать готовый материал.
Проверьте SVG в размере его использования, особенно если дизайн содержит надписи, узкие просветы или мелкие детали. Совпадение цветов с референсом не гарантируется, а несвязанные референсы могут конкурировать. Если набор иконок становится однообразным, меняйте объект, позу или расположение в промпте, сохраняя согласованный стиль. Полезный результат — единый векторный материал, формы и цвета которого можно менять в дизайнерском процессе, проверяя геометрию и читаемость по заданию.
В Ailoot выберите этот точный ID модели в /v1/images/generations и передайте творческий prompt. Сохраните каждый полученный элемент data независимо от того, содержит ли ответ URL или закодированное изображение, и сохраните сами байты с полученным типом содержимого. Храните usage и любой task_id медиа вместе с файлом, затем проверьте формы, надписи и цветовые области в целевом дизайне.
Ailoot Ultra · Images POST /v1/images/generations recraft/recraft-v4-styles-vector
recraft/recraft-v4-styles-vector
recraft/recraft-v4-styles-vectorНачало
Recraft V4 Styles Vector создаёт редактируемую SVG-графику по текстовому заданию и обязательному визуальному стилю. Модель подходит для согласованных иконок, логотипов и иллюстраций, в которых линии, палитра и отрисовка должны следовать одному направлению референсов.
- Допустимые входные данные
- Текст · Картинки
- Результаты
- Картинки
Доступно в Ailoot · входные данные и методы
Ailoot Ultra · Images POST /v1/images/generations
- Входные данные
text,image- Результат
image- Выходной формат
- Файл изображения
| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения recraft/recraft-v4-styles-vector Условия: Используйте этот селектор маршрутизации Ailoot в точности. | По умолчанию— |
Полеprompt | Типstring | ТребованиеОбязательно | Значения и ограничения Условия: | По умолчанию— |
Полеn | Типinteger | ТребованиеНеобязательно | Значения и ограничения Минимум: 1 Максимум: 6 Условия: | По умолчанию— |
Полеaspect_ratio | Типstring | ТребованиеНеобязательно | Значения и ограничения 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, auto Условия: | По умолчанию— |
Полеoutput_format | Типstring | ТребованиеНеобязательно | Значения и ограничения svg Условия: | По умолчанию— |
Полеinput_references | Типarray | ТребованиеОбязательно | Значения и ограничения Условия: | По умолчанию— |
Полеquality | Типstring | ТребованиеНеобязательно | Значения и ограничения auto, low, medium, high, xhigh, max Условия: | По умолчанию— |
Сочетания входных материалов
reference_guided_image
Параметры и жизненный цикл метода
| Параметр | Контракт |
|---|---|
Параметрcontent_type | Контрактapplication/json |
Параметрrequired | Контрактmodel, prompt, input_references |
Параметрoptional | Контрактn, aspect_ratio, output_format, 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.01 за запрос Только справочная оценка; итоговое списание определяется по зафиксированному исходному счёту. |
| Конфигурациявыходное изображение | Шкала ставок— | Прогноз количества— | Расчётная единицаза выходное изображение | Условия расчёта— | Плата Выход · выходное изображение · Оценка только для сравнения $0.1 за выходное изображение |
| КонфигурацияОриентировочная стоимость генерации | Шкала ставок— | Прогноз количестваОценка для одной генерации | Расчётная единица— | Условия расчёта— | Плата Выход · Оценочная стоимость генерации · Оценка только для сравнения $0.1 оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации. |
Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →
Примеры запросов
Ailoot Ultra · Images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
: "${AILOOT_IMAGE_URL:?Set an actual customer material or documented value}"
export AILOOT_IMAGE_URL
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "recraft/recraft-v4-styles-vector", "prompt": "A portrait of an Asian woman with neon green lights in the background, shallow depth of field.", "input_references": [{"type": "image_url", "image_url": {"url": "YOUR_ACCESSIBLE_IMAGE_URL"}}]}')
p['input_references'][0]['image_url']['url']=os.environ['AILOOT_IMAGE_URL']
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-styles-vector
Псевдонимы путей метода
Используйте пути методов, указанные выше.
Связанные ID для вызова
FAQ · Recraft: Recraft V4 Styles Vector
- Какие входные данные и результаты доступны?
POST /v1/images/generations·recraft/recraft-v4-styles-vector:text,image→image- Какие поля использует запрос?
POST /v1/images/generations·recraft/recraft-v4-styles-vector:model,prompt,n,aspect_ratio,output_format,input_references,quality- Какие ограничения действуют?
POST /v1/images/generations·recraft/recraft-v4-styles-vector:n.minimum:1;n.maximum:6