models

Recraft: Recraft V4.1 Utility Pro

Markdown · JSON

Recraft: Recraft V4.1 Utility Pro

Recraft V4.1 Utility Pro создаёт растровые изображения 2K с акцентом на простые, предсказуемые сцены, ровное освещение и фронтальную композицию. Он подходит для детальных изображений продуктов и мокапов, которым нужна ясная подача, а не выразительное художественное решение.

О модели

Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.

Recraft V4.1 Utility Pro — растровая версия с более высоким разрешением в ветке Utility семейства Recraft V4.1. Производитель противопоставляет прямую подачу Utility более выразительному выбору ракурса, освещения и композиции в основной модели V4.1. Utility предпочитает простые сцены, ровное освещение и объекты, показанные спереди. Поэтому он подходит для изображений в карточках товаров, мокапов и других задач, где объект должен легко считываться, а спокойная композиция отвечает цели.

Точный код модели — recraftv4_1_utility_pro. В справочнике поставщика указан растровый результат 2K с более тонкими деталями в формате WebP без потерь или PNG. Таблица размеров задаёт 2048 × 2048 пикселей для квадратных изображений и 2432 × 1792 для 4:3; другим поддерживаемым соотношениям сторон соответствуют свои размеры. Этим Utility Pro отличается от стандартного Utility с результатом 1K. Изображение при этом не становится редактируемым векторным файлом; для такой задачи версия Vector выдаёт SVG.

Начните с задания, в котором названы объект, материал, угол обзора, фон и несколько обязательных видимых деталей. Для карточки товара запросите керамическую банку для хранения, показанную спереди на светлой нейтральной поверхности, с равномерным освещением, закрытой крышкой и свободным пространством вокруг силуэта. Если сцена должна оставаться простой, скажите об этом прямо, не рассчитывая, что название Utility кодирует все решения по подаче. Для серии товарных изображений сохраняйте требования к кадрированию и фону, меняя описание продукта.

Справочник генерации V4.1 поддерживает запросы длиной до 10,000 символов, настройки предпочтительных цветов и цвета фона, случайный seed и от одного до шести результатов. Совместимый сохранённый стиль или необязательные изображения-референсы могут направлять внешний вид; в отдельном семействе V4 Styles стиль всегда обязателен. Для необязательных референсов используйте ясные материалы с согласованным визуальным направлением. Точное воспроизведение цвета из референса не гарантируется, поэтому требование фирменного цвета всё равно нужно явно описать и проверить в результате. Для генерации изображений по стилевым референсам используйте от одного до десяти изображений PNG, JPG или WebP общим объёмом не более 64 MB и менее 20 MB каждое. У каждого референса короткая сторона должна быть не менее 256 пикселей, длинная — не более 4,096 пикселей, а разрешение — не более 16 мегапикселей. Используйте либо эти референсы, либо совместимый сохранённый стиль, а не оба варианта одновременно. При генерации изображений по стилевым референсам гибкое соответствие допускает более свободную интерпретацию, а точное соответствие ближе следует характеру изображения, палитре, композиции и освещению.

Recraft также документирует для линии V4.1 преобразование изображения в изображение: существующее изображение сочетается с запросом и силой изменения от 0 до 1. Более низкое значение сохраняет большую близость к исходнику, а более высокое допускает более значительные изменения. Это полезно, когда исходная композиция или объект должны определять новую версию. В той же операции преобразования не принимаются настройки пользовательских стилей V4.1. Ограничения поставщика для входного изображения: менее 20 MB, до 16 MP и стороны от 256 до 4096 пикселей.

На Utility Pro распространяются ограничения V4.1 для negative_prompt, названий предустановленных стилей, text_layout, artistic_level и no_text. Дайте положительное описание нужной сцены, а точную работу с надписями или макетом при необходимости оставьте подходящему завершающему этапу. Проверьте изображение продукта на соответствие переданному материалу, форме и необходимым деталям, прежде чем использовать его как достоверный материал карточки товара. Полезный результат — растровая композиция большего размера, подготовленная по ясному заданию для продукта или мокапа, при этом точные сведения о продукте остаются теми, которые были переданы в задаче.

Ailoot Ultra · Картинки POST /v1/images/generations recraft/recraft-v4.1-utility-pro

recraft/recraft-v4.1-utility-pro

Recraft /recraft/recraft-v4.1-utility-pro

Начало

Recraft V4.1 Utility Pro создаёт растровые изображения 2K с акцентом на простые, предсказуемые сцены, ровное освещение и фронтальную композицию. Он подходит для детальных изображений продуктов и мокапов, которым нужна ясная подача, а не выразительное художественное решение.

Допустимые входные данные
Текст · Картинки
Результаты
Картинки

Доступно в Ailoot · входные данные и методы

Ailoot Ultra · Картинки POST /v1/images/generations
Входные данные
text, image
Результат
image
ПолеТипТребованиеЗначения и ограниченияПо умолчанию
ПолеmodelТипstringТребованиеОбязательноЗначения и ограничения
recraft/recraft-v4.1-utility-pro
По умолчанию—
ПолеpromptТипstringТребованиеОбязательноЗначения и ограничения
Минимальная длина: 1
По умолчанию—
Полеaspect_ratioТипstringТребованиеНеобязательноЗначения и ограничения
1:1, 4:3, 3:4, 16:9, 9:16, auto
По умолчанию—
ПолеnТипintegerТребованиеНеобязательноЗначения и ограничения
Минимум: 1
Максимум: 6
По умолчанию—
Полеinput_referencesТипarrayТребованиеНеобязательноЗначения и ограничения
Минимум элементов: 0
Максимум элементов: 1
По умолчанию—
ПолеproviderТипobjectТребованиеНеобязательноЗначения и ограниченияПо умолчанию—
Параметры и жизненный цикл метода
ПараметрКонтракт
Параметрcontent_typeКонтрактapplication/json
ПараметрrequiredКонтрактmodel, prompt
Параметрmaterial_typesКонтрактtext, image

Жизненный цикл: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Фактически возвращённый task_id или запись в медиатеке

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Тарифы

Как рассчитывается итоговая плата

Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом.

Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.

Быстрый режим
Не указано При выборе быстрого режима
Режим flex
Не указано При выборе режима flex
Максимальная интенсивность рассуждений
Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)

Оценочные ставки для сравнения

Цены по конфигурациям

Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.

КонфигурацияШкала ставокПрогноз количестваРасчётная единицаПлата
КонфигурацияБазовые тарифы на токеныШкала ставокБазовая ставкаПрогноз количества—Расчётная единица—Плата
Вход · Входные токены · Оценка только для сравнения — / 1K токенов
Выход · Выходные токены · Оценка только для сравнения — / 1K токенов
Вход · Чтение кэша · Оценка только для сравнения — / 1K токенов
Вход · Запись в кэш · Оценка только для сравнения — / 1K токенов
Вход · Запись в кэш, 1 час · Оценка только для сравнения — / 1K токенов
Конфигурациявыходное изображениеШкала ставок—Прогноз количества—Расчётная единицаза выходное изображениеПлата
Выход · выходное изображение · Оценка только для сравнения $0.42 за выходное изображение
КонфигурацияОриентировочная стоимость генерацииШкала ставок—Прогноз количестваОценка для одной генерацииРасчётная единица—Плата
Выход · Оценочная стоимость генерации · Оценка только для сравнения $0.42 оценка до генерации

Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации.

Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →

Примеры запросов

Ailoot Ultra · Картинки

curl
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'recraft/recraft-v4.1-utility-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

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
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

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

Ailoot Ultra · Картинки

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

  • GET /v1/media/tasks/{task_id}
  • GET /v1/media/assets/{asset_id}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Чтение другого содержимого
Читать существующие материалы, принадлежащие вам
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
Сохраняйте все готовые результаты

Сохраните каждое готовое изображение; загрузите содержимое по каждому полученному URL или декодируйте его содержимое Base64.

Сохраняйте полный ответ и заголовки, все фактические результаты, исходные возвращённые идентификаторы и все поля использования. Восстанавливайте исходную операцию без повторной отправки запроса создания.

Если нужно проверить исходный ответ

Сохраните возвращённый X-Client-Request-ID для сверки. Читайте только фактически возвращённые значения task_id/asset_id или собственную медиатеку; никогда не составляйте URL задачи из ID операции и никогда не отправляйте запрос создания повторно.

Поля ответа
ПолеТип
ПолеcreatedТип
Полеdata[].urlТип
Полеdata[].b64_jsonТип
ПолеusageТип

Псевдонимы

Псевдонимы моделей

Ailoot Ultra recraft/recraft-v4.1-utility-pro

Псевдонимы путей метода

/v1/images

Связанные ID для вызова

recraft/recraft-v4.1-utility-pro

FAQ · Recraft: Recraft V4.1 Utility Pro
Какие входные данные и результаты доступны?

POST /v1/images/generations · recraft/recraft-v4.1-utility-pro: text, image → image

Какие поля использует запрос?

POST /v1/images/generations · recraft/recraft-v4.1-utility-pro: model, prompt, aspect_ratio, n, input_references, provider

Какие ограничения действуют?

POST /v1/images/generations · recraft/recraft-v4.1-utility-pro: n.minimum: 1; n.maximum: 6

Подробнее

Подключите Ailoot к Claude Code, OpenCode, Hermes или своему приложению.

Компания и портфель её проектов

Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно.

Покупайте токены со скидкой.

Скидка по подписке для регулярной работы. Промокоды — до 50% на покупку токенов.

Подписка
Выберите тариф со скидкой для своих регулярных запросов.
Промокод до 50%
Введите код при покупке. Цена пересчитается с учётом действующей акции.
Расходы в истории
Модель, токены и сумма сохраняются для каждого запроса.

Выбрать подписку · Посмотреть цены моделей

Подключайте API к продукту, который вы продаёте.

SaaS, приложения и боты — по оферте и лицензионному договору Ailoot. Для перепродажи запросите реселлерскую лицензию.

Коммерческое приложение
Встраивайте генерацию текста, картинок, видео и звука в платные функции своего сервиса.
Лицензия для реселлера
Пришлите описание проекта и схему доступа. Запросите письменные условия использования и перепродажи.
Документы на сайте
Оферта, лицензионный договор и политика обработки данных доступны до подключения.

Запросить реселлерскую лицензию · Оферта и лицензионный договор