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