{ "aboutHtml": "

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 медиа вместе с файлом, затем проверьте формы, надписи и цветовые области в целевом дизайне.

", "aboutText": "Recraft V4.1 Pro Vector — версия Pro для SVG из семейства генерации изображений V4.1 от Recraft. Она предназначена для работ, где результат должен остаться редактируемой векторной графикой: логотипа, типографической концепции, иконки или иллюстрации. В презентации V4.1 разработчик подчёркивает продуманную композицию и иллюстрацию, а документация конкретной модели отделяет этот вариант от стандартных версий Vector, растровой Pro и Utility. Итоговое изображение — SVG, а не растровый экспорт высокого разрешения.\n\nКод модели разработчика — recraftv4_1_pro_vector. Векторный вывод не имеет фиксированного размера в пикселях; справочник размеров принимает четырнадцать соотношений ширины к высоте для векторных моделей и не принимает точные пиксельные размеры. Поэтому растровые настройки Pro 2K не определяют разрешение SVG этой версии. Задайте нужные пропорции и назначение графики. Для логотипа важны читаемый силуэт и редактируемые цветовые области, которые можно доработать в дизайнерском процессе.\n\nМодель поддерживает генерацию по тексту и необязательные референсы пользовательского стиля. Документированный лимит промпта — 10 000 символов. Предпочтительные цвета, желаемый цвет фона и случайный seed могут направлять генерацию; сценарий допускает от одного до шести результатов. Совместимый сохранённый стиль или изображения-референсы могут задать визуальный язык; стиль должен соответствовать модели, для которой был создан. Основная линия V4.1 не требует стилевого референса в каждом запросе, в отличие от отдельного семейства V4 Styles. Для генерации со стилем по референсам используйте от одного до десяти изображений PNG, JPG или WebP, суммарно не более 64 МБ и менее 20 МБ каждое. Короткая сторона каждого референса должна быть не менее 256 пикселей, длинная — не более 4 096 пикселей, разрешение — не более 16 мегапикселей. Используйте либо эти референсы, либо совместимый сохранённый стиль, а не оба варианта вместе. При генерации по стилевым референсам гибкое сопоставление допускает более свободную интерпретацию, а точное ближе следует отрисовке, палитре, композиции и освещению.\n\nПолезное задание на векторную графику задаёт тип рисунка, логику форм, палитру, характер линий и расположение до декоративных деталей. Для эмблемы садового магазина запросите один силуэт ростка, округлую геометрию, два плоских цвета и центральную компоновку. Для леттеринга включите точное слово и опишите его иерархию и форму, затем проверьте в полученном SVG читаемость внутрибуквенных просветов, интервалы и ясность в малом размере. Векторные примеры разработчика показывают выразительную типографику и иллюстрацию; они не гарантируют, что все сгенерированные буквы и контуры уже готовы к использованию.\n\nRecraft документирует отдельный сценарий 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 пикселей.\n\nV4.1 не поддерживает названия готовых стилей и настройки negative_prompt, text_layout, artistic_level или no_text. Укажите желаемое расположение и надписи в позитивном задании, а не полагайтесь на старые механизмы V3. Для детального брендового материала используйте SVG как рабочий файл, проверьте геометрию и при необходимости скорректируйте цвета или формы до размещения в конечном макете. Эта версия Pro Vector сохраняет свою отдельную идентичность; она не взаимозаменяема со стандартными растровыми вариантами или Utility только потому, что они носят имя V4.1.\n\nВ Ailoot выберите этот точный ID модели в /v1/images/generations и передайте творческий prompt. Сохраните каждый полученный элемент data независимо от того, содержит ли ответ URL или закодированное изображение, и сохраните сами байты с полученным типом содержимого. Храните usage и любой task_id медиа вместе с файлом, затем проверьте формы, надписи и цветовые области в целевом дизайне.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "cac20f6bafdd52f644d2be39610baf91a9d7c4a6253e48dd5b905f3dae04898f", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ru", "methods": [ { "html": "
•

Recraft: Recraft V4.1 Pro Vector

Прочее /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 · входные данные и методы

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\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=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."}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\n# Submit once. Retain the complete result, original identifiers and every response header.\n

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

Ailoot Ultra · Images

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

Сохраняйте все готовые результаты

Сохраните каждое готовое изображение; загрузите содержимое по каждому полученному 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 для вызова

recraft/recraft-v4.1-pro-vector

", "method_identity": { "effective_request_model_id": "recraft/recraft-v4.1-pro-vector", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "recraft/recraft-v4.1-pro-vector", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|recraft%2Frecraft-v4.1-pro-vector", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "The displayed rates estimate the cost before generation. The final charge is calculated from the cost recorded for the original generation. Measured output duration and forecast quantities are not the final billable quantity.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain the complete response and headers, original identifiers, every actual output and all usage/accounting fields. Save each unique owned asset and retain every role pointing to it.", "authentication": { "header": "Authorization", "scheme": "Bearer", "value": "$AILOOT_API_KEY" }, "control_semantics": { "other_documented_controls": "Source generic image parsing preserves request JSON. Additional documented controls stay subject to the exact model; missing DTO fields do not create Source refusals.", "quality": "The saved common image schema documents this control and says providers without a quality knob ignore it.", "style": "Selected generic Source passes JSON fields through but the saved dedicated image request schema does not declare a style field. Its omission here is not a Source ban or a supported per-model promise." }, "errors": [ { "condition": "Обязательное поле, селектор модели, тип или представление входных данных недопустимы.", "http_status": 400, "recovery": "Изучите возвращённые сведения о проверке данных перед подготовкой отдельного запроса.", "type": "invalid_request_error" }, { "condition": "Исходный запрос или результат неизвестен либо требует проверки.", "http_status": null, "recovery": "Сохраните исходные идентификаторы и заголовки; читайте только поддерживаемые записи статуса или библиотеки. Не отправляйте запрос на создание повторно.", "type": null } ], "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned signed URL; never construct a token." }, "status": [ { "http": "GET", "id_source": "actual returned task_id or selected library record; operation_id is a separate identifier", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Сохраните исходный X-Client-Request-ID, ответ и заголовки. Неизвестный результат или result_pending_check не разрешает повторное создание.", "unknown_no_replay": true }, "material_combinations": [ { "materials": [ "text", "image" ], "metadata_authority": "saved_model_discovery_union", "mode": "text_to_image", "reference_maximum": 1, "reference_minimum": 0 } ], "model_parameter_metadata": { "authority": "saved_model_discovery_union", "defaults_not_inferred": { "aspect_ratio": null, "exact_pixels": null, "explanation": "No universal/model default inferred. Omitted output_format uses provider default; dimensions are provider-derived, observed Ming2048 is not a universal default.", "n": null, "output_format": null, "quality": null, "resolution": null }, "known_parameter_choices": { "aspect_ratio": { "type": "enum", "values": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ] }, "input_references": { "max": 1, "min": 0, "type": "range" }, "n": { "max": 6, "min": 1, "type": "range" }, "output_format": { "type": "enum", "values": [ "svg" ] } }, "pointer": "/profiles/36", "scope": "Exact saved model metadata. Discovery unions are identified explicitly and are not represented as definitive selected-provider bounds." }, "outputs": { "all_results": "Сохраните полный ответ и заголовки, исходные идентификаторы, каждый фактический результат и все поля использования и учёта. Сохраните каждый уникальный ресурс, принадлежащий Ailoot, и каждую роль, которая на него ссылается.", "documented_formats": [ "svg" ], "every_actual_output": true, "family": "image", "fields": [ { "name": "data[].url", "type": "string" }, { "name": "data[].b64_json", "type": "string" }, { "name": "usage", "type": "object" } ], "format": "The exact saved model metadata lists SVG. Preserve the actual returned MIME and unchanged vector bytes; keep every actual output and owned signed image link." }, "parameters": [ { "conditions": "Используйте этот селектор маршрутизации Ailoot в точности.", "default_known": false, "enum": [ "recraft/recraft-v4.1-pro-vector" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "conditions": "", "default_known": false, "enum_known": false, "name": "prompt", "required": true, "type": "string" }, { "conditions": "", "default_known": false, "enum_known": false, "maximum": 6, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "conditions": "", "default_known": false, "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ], "enum_known": true, "name": "aspect_ratio", "required": false, "type": "string" }, { "conditions": "", "default_known": false, "enum": [ "svg" ], "enum_known": true, "name": "output_format", "required": false, "type": "string" }, { "conditions": "", "default_known": false, "enum_known": false, "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maxItems": 1, "minItems": 0, "name": "input_references", "required": false, "type": "array" }, { "conditions": "", "default_known": false, "enum": [ "auto", "low", "medium", "high", "xhigh", "max" ], "enum_known": true, "name": "quality", "required": false, "type": "string" } ], "request_schema": { "additionalProperties": true, "properties": { "aspect_ratio": { "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ], "type": "string" }, "input_references": { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maxItems": 1, "minItems": 0, "type": "array" }, "model": { "enum": [ "recraft/recraft-v4.1-pro-vector" ], "type": "string" }, "n": { "maximum": 6, "minimum": 1, "type": "integer" }, "output_format": { "enum": [ "svg" ], "type": "string" }, "prompt": { "type": "string" }, "quality": { "enum": [ "auto", "low", "medium", "high", "xhigh", "max" ], "type": "string" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "actual_file_preparation_required": false, "body": { "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." }, "content_type": "application/json", "example_is_offline_content": true }, "usage": { "meter": "Use the accepted method price and actual recorded usage; the request reserve is an estimate. A billing unit does not add an input capability.", "preserve": "Keep all returned usage, accounting and request identifiers with every actual output.", "settlement": "Retain the original operation; reconcile its result and accounting once." } }, "input": { "conditions": [ "Используйте этот селектор маршрутизации Ailoot в точности.", "Качество — общий документированный параметр; поставщики без настройки качества его игнорируют. Улучшение качества для каждой модели не обещается." ], "content_type": "application/json", "material_types": [ "text", "image" ], "optional": [ "n", "aspect_ratio", "output_format", "input_references", "quality" ], "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned signed URL; never construct a token." }, "status": [ { "http": "GET", "id_source": "Фактически возвращённый task_id или выбранная запись библиотеки; operation_id — отдельный идентификатор", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Keep the original X-Client-Request-ID, response and headers. An unknown or result_pending_check outcome does not authorize a second creation.", "unknown_no_replay": true }, "method": { "http": "POST", "path": "/v1/images/generations" }, "method_aliases": [], "output": { "all_results": "Retain the complete response and headers, original identifiers, every actual output and all usage/accounting fields. Save each unique owned asset and retain every role pointing to it.", "documented_formats": [ "svg" ], "every_actual_output": true, "family": "image", "fields": [ { "name": "data[].url", "type": "string" }, { "name": "data[].b64_json", "type": "string" }, { "name": "usage", "type": "object" } ], "format": "The saved exact model metadata lists SVG. Preserve actual MIME and bytes; storage MIME support alone does not prove completion of the full selected generic output path." } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quoted_unit": "per output image" }, "label": "output image", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "output image", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "per output image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Ориентировочная стоимость генерации", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=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.\"}')\n\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\n# Submit once. Retain the complete result, original identifiers and every response header.\n", "label": "curl · create once and retain the complete result", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "images", "http": "POST", "in": null, "input": [ "text", "image" ], "input_conditions": { "image": "Use the exact model reference-input range in the saved model metadata; a reference becomes required only for the models whose listed minimum is positive." }, "label": "Images", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "image" ], "path": "/v1/images/generations", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quoted_unit": "per output image" }, "label": "output image", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "output image", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "per output image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "recraft/recraft-v4.1-pro-vector", "route_label": "Ultra", "status_reads": [ "GET /v1/media/tasks/{task_id}" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "output image", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "per output image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" }, { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } } ], "model_id": "recraft/recraft-v4.1-pro-vector", "nativeProvenance": { "input_facts_canonical_sha256": "cce225ae62f5ac82ea19394c7341363748576cf2d9eb6a89b30700774c36aa13", "input_html_sha256": "2819d498a2ab2d7a788def70701fd8b5dccbf3d34ffddf266de99d8ff0a6bd2d", "private_audit_sha256": "0f940ed13009255b8a6fd87889340ca259ed7bdb6a749848cf9d220c2ed2f6c2", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/ru/recraft-recraft-v4-1-pro-vector/", "description": "Recraft V4.1 Pro Vector создаёт редактируемую SVG-графику для логотипов, леттеринга и детальных иллюстраций. Это векторная версия Pro семейства V4.1, объединяющая текстовые промпты с необязательными изображениями и стилями и сохраняющая векторный результат.", "locale": "ru", "md_url": "https://ailoot.ai/models/ru/recraft-recraft-v4-1-pro-vector/index.md", "title": "Recraft: Recraft V4.1 Pro Vector — Ailoot", "url": "https://ailoot.ai/models/ru/recraft-recraft-v4-1-pro-vector/" }, "rawModel": { "about": "Recraft V4.1 Pro Vector — версия Pro для SVG из семейства генерации изображений V4.1 от Recraft. Она предназначена для работ, где результат должен остаться редактируемой векторной графикой: логотипа, типографической концепции, иконки или иллюстрации. В презентации V4.1 разработчик подчёркивает продуманную композицию и иллюстрацию, а документация конкретной модели отделяет этот вариант от стандартных версий Vector, растровой Pro и Utility. Итоговое изображение — SVG, а не растровый экспорт высокого разрешения.\n\nКод модели разработчика — recraftv4_1_pro_vector. Векторный вывод не имеет фиксированного размера в пикселях; справочник размеров принимает четырнадцать соотношений ширины к высоте для векторных моделей и не принимает точные пиксельные размеры. Поэтому растровые настройки Pro 2K не определяют разрешение SVG этой версии. Задайте нужные пропорции и назначение графики. Для логотипа важны читаемый силуэт и редактируемые цветовые области, которые можно доработать в дизайнерском процессе.\n\nМодель поддерживает генерацию по тексту и необязательные референсы пользовательского стиля. Документированный лимит промпта — 10 000 символов. Предпочтительные цвета, желаемый цвет фона и случайный seed могут направлять генерацию; сценарий допускает от одного до шести результатов. Совместимый сохранённый стиль или изображения-референсы могут задать визуальный язык; стиль должен соответствовать модели, для которой был создан. Основная линия V4.1 не требует стилевого референса в каждом запросе, в отличие от отдельного семейства V4 Styles. Для генерации со стилем по референсам используйте от одного до десяти изображений PNG, JPG или WebP, суммарно не более 64 МБ и менее 20 МБ каждое. Короткая сторона каждого референса должна быть не менее 256 пикселей, длинная — не более 4 096 пикселей, разрешение — не более 16 мегапикселей. Используйте либо эти референсы, либо совместимый сохранённый стиль, а не оба варианта вместе. При генерации по стилевым референсам гибкое сопоставление допускает более свободную интерпретацию, а точное ближе следует отрисовке, палитре, композиции и освещению.\n\nПолезное задание на векторную графику задаёт тип рисунка, логику форм, палитру, характер линий и расположение до декоративных деталей. Для эмблемы садового магазина запросите один силуэт ростка, округлую геометрию, два плоских цвета и центральную компоновку. Для леттеринга включите точное слово и опишите его иерархию и форму, затем проверьте в полученном SVG читаемость внутрибуквенных просветов, интервалы и ясность в малом размере. Векторные примеры разработчика показывают выразительную типографику и иллюстрацию; они не гарантируют, что все сгенерированные буквы и контуры уже готовы к использованию.\n\nRecraft документирует отдельный сценарий 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 пикселей.\n\nV4.1 не поддерживает названия готовых стилей и настройки negative_prompt, text_layout, artistic_level или no_text. Укажите желаемое расположение и надписи в позитивном задании, а не полагайтесь на старые механизмы V3. Для детального брендового материала используйте SVG как рабочий файл, проверьте геометрию и при необходимости скорректируйте цвета или формы до размещения в конечном макете. Эта версия Pro Vector сохраняет свою отдельную идентичность; она не взаимозаменяема со стандартными растровыми вариантами или Utility только потому, что они носят имя V4.1.\n\nВ Ailoot выберите этот точный ID модели в /v1/images/generations и передайте творческий prompt. Сохраните каждый полученный элемент data независимо от того, содержит ли ответ URL или закодированное изображение, и сохраните сами байты с полученным типом содержимого. Храните usage и любой task_id медиа вместе с файлом, затем проверьте формы, надписи и цветовые области в целевом дизайне.", "alias_of": null, "aliases": [], "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "Полная информация о ценах конфигурации — в подробностях." } ], "ctx": null, "formats": [ "images" ], "id": "recraft/recraft-v4.1-pro-vector", "input": [ "text", "image" ], "kind": "image", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "The displayed rates estimate the cost before generation. The final charge is calculated from the cost recorded for the original generation. Measured output duration and forecast quantities are not the final billable quantity.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain the complete response and headers, original identifiers, every actual output and all usage/accounting fields. Save each unique owned asset and retain every role pointing to it.", "authentication": { "header": "Authorization", "scheme": "Bearer", "value": "$AILOOT_API_KEY" }, "control_semantics": { "other_documented_controls": "Source generic image parsing preserves request JSON. Additional documented controls stay subject to the exact model; missing DTO fields do not create Source refusals.", "quality": "The saved common image schema documents this control and says providers without a quality knob ignore it.", "style": "Selected generic Source passes JSON fields through but the saved dedicated image request schema does not declare a style field. Its omission here is not a Source ban or a supported per-model promise." }, "errors": [ { "condition": "Обязательное поле, селектор модели, тип или представление входных данных недопустимы.", "http_status": 400, "recovery": "Изучите возвращённые сведения о проверке данных перед подготовкой отдельного запроса.", "type": "invalid_request_error" }, { "condition": "Исходный запрос или результат неизвестен либо требует проверки.", "http_status": null, "recovery": "Сохраните исходные идентификаторы и заголовки; читайте только поддерживаемые записи статуса или библиотеки. Не отправляйте запрос на создание повторно.", "type": null } ], "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned signed URL; never construct a token." }, "status": [ { "http": "GET", "id_source": "actual returned task_id or selected library record; operation_id is a separate identifier", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Сохраните исходный X-Client-Request-ID, ответ и заголовки. Неизвестный результат или result_pending_check не разрешает повторное создание.", "unknown_no_replay": true }, "material_combinations": [ { "materials": [ "text", "image" ], "metadata_authority": "saved_model_discovery_union", "mode": "text_to_image", "reference_maximum": 1, "reference_minimum": 0 } ], "model_parameter_metadata": { "authority": "saved_model_discovery_union", "defaults_not_inferred": { "aspect_ratio": null, "exact_pixels": null, "explanation": "No universal/model default inferred. Omitted output_format uses provider default; dimensions are provider-derived, observed Ming2048 is not a universal default.", "n": null, "output_format": null, "quality": null, "resolution": null }, "known_parameter_choices": { "aspect_ratio": { "type": "enum", "values": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ] }, "input_references": { "max": 1, "min": 0, "type": "range" }, "n": { "max": 6, "min": 1, "type": "range" }, "output_format": { "type": "enum", "values": [ "svg" ] } }, "pointer": "/profiles/36", "scope": "Exact saved model metadata. Discovery unions are identified explicitly and are not represented as definitive selected-provider bounds." }, "outputs": { "all_results": "Сохраните полный ответ и заголовки, исходные идентификаторы, каждый фактический результат и все поля использования и учёта. Сохраните каждый уникальный ресурс, принадлежащий Ailoot, и каждую роль, которая на него ссылается.", "documented_formats": [ "svg" ], "every_actual_output": true, "family": "image", "fields": [ { "name": "data[].url", "type": "string" }, { "name": "data[].b64_json", "type": "string" }, { "name": "usage", "type": "object" } ], "format": "The exact saved model metadata lists SVG. Preserve the actual returned MIME and unchanged vector bytes; keep every actual output and owned signed image link." }, "parameters": [ { "conditions": "Используйте этот селектор маршрутизации Ailoot в точности.", "default_known": false, "enum": [ "recraft/recraft-v4.1-pro-vector" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "conditions": "", "default_known": false, "enum_known": false, "name": "prompt", "required": true, "type": "string" }, { "conditions": "", "default_known": false, "enum_known": false, "maximum": 6, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "conditions": "", "default_known": false, "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ], "enum_known": true, "name": "aspect_ratio", "required": false, "type": "string" }, { "conditions": "", "default_known": false, "enum": [ "svg" ], "enum_known": true, "name": "output_format", "required": false, "type": "string" }, { "conditions": "", "default_known": false, "enum_known": false, "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maxItems": 1, "minItems": 0, "name": "input_references", "required": false, "type": "array" }, { "conditions": "", "default_known": false, "enum": [ "auto", "low", "medium", "high", "xhigh", "max" ], "enum_known": true, "name": "quality", "required": false, "type": "string" } ], "request_schema": { "additionalProperties": true, "properties": { "aspect_ratio": { "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ], "type": "string" }, "input_references": { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maxItems": 1, "minItems": 0, "type": "array" }, "model": { "enum": [ "recraft/recraft-v4.1-pro-vector" ], "type": "string" }, "n": { "maximum": 6, "minimum": 1, "type": "integer" }, "output_format": { "enum": [ "svg" ], "type": "string" }, "prompt": { "type": "string" }, "quality": { "enum": [ "auto", "low", "medium", "high", "xhigh", "max" ], "type": "string" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "actual_file_preparation_required": false, "body": { "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." }, "content_type": "application/json", "example_is_offline_content": true }, "usage": { "meter": "Use the accepted method price and actual recorded usage; the request reserve is an estimate. A billing unit does not add an input capability.", "preserve": "Keep all returned usage, accounting and request identifiers with every actual output.", "settlement": "Retain the original operation; reconcile its result and accounting once." } }, "input": { "conditions": [ "Используйте этот селектор маршрутизации Ailoot в точности.", "Качество — общий документированный параметр; поставщики без настройки качества его игнорируют. Улучшение качества для каждой модели не обещается." ], "content_type": "application/json", "material_types": [ "text", "image" ], "optional": [ "n", "aspect_ratio", "output_format", "input_references", "quality" ], "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned signed URL; never construct a token." }, "status": [ { "http": "GET", "id_source": "Фактически возвращённый task_id или выбранная запись библиотеки; operation_id — отдельный идентификатор", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Keep the original X-Client-Request-ID, response and headers. An unknown or result_pending_check outcome does not authorize a second creation.", "unknown_no_replay": true }, "method": { "http": "POST", "path": "/v1/images/generations" }, "method_aliases": [], "output": { "all_results": "Retain the complete response and headers, original identifiers, every actual output and all usage/accounting fields. Save each unique owned asset and retain every role pointing to it.", "documented_formats": [ "svg" ], "every_actual_output": true, "family": "image", "fields": [ { "name": "data[].url", "type": "string" }, { "name": "data[].b64_json", "type": "string" }, { "name": "usage", "type": "object" } ], "format": "The saved exact model metadata lists SVG. Preserve actual MIME and bytes; storage MIME support alone does not prove completion of the full selected generic output path." } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quoted_unit": "per output image" }, "label": "output image", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "output image", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "per output image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Ориентировочная стоимость генерации", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=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.\"}')\n\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\n# Submit once. Retain the complete result, original identifiers and every response header.\n", "label": "curl · create once and retain the complete result", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "images", "http": "POST", "in": null, "input": [ "text", "image" ], "input_conditions": { "image": "Use the exact model reference-input range in the saved model metadata; a reference becomes required only for the models whose listed minimum is positive." }, "label": "Images", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "image" ], "path": "/v1/images/generations", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quoted_unit": "per output image" }, "label": "output image", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "output image", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "per output image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "recraft/recraft-v4.1-pro-vector", "route_label": "Ultra", "status_reads": [ "GET /v1/media/tasks/{task_id}" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "output image", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "per output image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" }, { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "model_aliases": [ { "canonical_model_id": "recraft/recraft-v4.1-pro-vector", "request_model_id": "recraft/recraft-v4.1-pro-vector", "route_label": "Ultra" } ], "name": "Recraft: Recraft V4.1 Pro Vector", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 0.6, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 0.6, "varies": false }, "short": "Recraft V4.1 Pro Vector создаёт редактируемую SVG-графику для логотипов, леттеринга и детальных иллюстраций. Это векторная версия Pro семейства V4.1, объединяющая текстовые промпты с необязательными изображениями и стилями и сохраняющая векторный результат.", "title": "Recraft: Recraft V4.1 Pro Vector" }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "Recraft V4.1 Pro Vector создаёт редактируемую SVG-графику для логотипов, леттеринга и детальных иллюстраций. Это векторная версия Pro семейства V4.1, объединяющая текстовые промпты с необязательными изображениями и стилями и сохраняющая векторный результат.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "a5bcddf17690f3fa694804180c01131043ba42808f7fcc9326a83627709a90bb", "renderer_sha256": "aa692ffec412026bdeaf316df24a58e6c5083045e5246f6033f898d132afa5ff" }, "sourceRevision": "d8af79ec24987c96773f8f99a249d03aea573d54011ff77b224cd3f5ed1d02e1" }