Sourceful: Riverflow V2.5 Pro

Riverflow 2.5 Pro — профиль Sourceful для генерации и редактирования изображений продуктов и рекламных креативов с акцентом на качество. Семейство объединяет многошаговое редактирование, собственные критерии оценки и управление шрифтами, помогая подробному заданию сохранять идентичность бренда и задуманный макет.

Ailoot Ultra · Картинки POST /v1/images/generations sourceful/riverflow-v2.5-pro

О модели

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

Riverflow 2.5 Pro — профиль Pro семейства Sourceful Riverflow 2.5 для генерации и редактирования изображений, предназначенный для творческой работы, где важны управляемость и качество конечного изображения. Текстовое задание позволяет создать визуальный материал, а изображения-референсы задают продукт, иллюстрацию или сцену для редактирования. Отличительный подход семейства — планирование нескольких шагов редактирования, проверка вариантов и их исправление под нужный результат, вместо признания первого изображения завершённым процессом.

Для изображения кампании подготовьте референсы продукта и направление бренда до описания сцены. Укажите особенности, отличающие один SKU от другого, расположение, освещение и место под текст. Полезное задание может объединить три помеченных продукта в одну цельную композицию, сохранив различия в их цветах, размерах и видимых признаках. Для сцены с одним продуктом в жизненном окружении обозначьте, какой референс задаёт предмет, а какой — настроение или обстановку, затем перечислите то, что следует сохранить при преобразовании.

Riverflow 2.5 добавляет собственную шкалу оценки к процессу рассуждения и проверки. Опишите критерии, важные для материала: узнаваемость продукта, читаемость этикетки, композицию, правдоподобие сцены или количество места для заголовка. После шагов редактирования модель рассуждения может оценить варианты по этой шкале и решить, как продолжить. Изображение для упаковки и выразительный визуал кампании требуют разных приоритетов проверки, поэтому отделяйте инструкцию генерации от критериев оценки.

Уровень усилий при рассуждении определяет объём итеративной работы и строгость проверки, которую семейство применяет перед принятием изображения. У производителя процесс версии 2.5 охватывает уровни от low до xhigh: меньшие усилия подходят для раннего поиска идей, большие — когда заданию нужна дополнительная доработка. Дополнительная внутренняя проверка не отменяет осмотр готового материала. Для сложной продуктовой композиции явно задайте важные детали и критерии приёмки, чтобы у дополнительных шагов редактирования была понятная цель.

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

Семейство 2.5 предоставляет режимы обычного, однотонного и прозрачного фона, включая прозрачный PNG для монтажа, с экспортом в 1K, 2K и до 4K. Выбирайте материал под его размещение: вырезанный объект для сборки другого дизайна, управляемый однотонный фон для единых серий продуктов или готовую сцену кампании. Подготовьте форму результата и размещение текста вместе: увеличение детализации выдачи не исправит композицию с основным объектом в неверном месте.

Pro отличается от профиля Fast и от предыдущего поколения Riverflow 2.0. Семейство 2.5 развивает многошаговую основу 2.0, добавляя более глубокое управление проверкой, собственные критерии оценки и расширенный выбор фона и экспорта. При итоговой проверке полезно сравнить изображение с референсами продукта, шкалой оценки и типографикой, затем изменить конкретную инструкцию или критерий, ответственный за несоответствие. Сохраняйте выбранное изображение вместе с заданием и референсами, чтобы следующая правка развивала то же творческое направление и сохраняла установленную идентичность.

Ailoot Ultra · Картинки POST /v1/images/generations sourceful/riverflow-v2.5-pro

sourceful/riverflow-v2.5-pro

Sourceful /sourceful/riverflow-v2.5-pro

Начало

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

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

Ailoot Ultra · Картинки POST /v1/images/generations

Входные данные: text, image
Результат: image

Поле	Тип	Требование	Значения и ограничения	По умолчанию
Поле`model`	Тип`string`	ТребованиеОбязательно	Значения и ограничения sourceful/riverflow-v2.5-pro	По умолчанию—
Поле`prompt`	Тип`string`	ТребованиеОбязательно	Значения и ограничения Минимальная длина: 1	По умолчанию—
Поле`resolution`	Тип`string`	ТребованиеНеобязательно	Значения и ограничения 1K, 2K, 4K	По умолчанию—
Поле`aspect_ratio`	Тип`string`	ТребованиеНеобязательно	Значения и ограничения 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto	По умолчанию—
Поле`output_format`	Тип`string`	ТребованиеНеобязательно	Значения и ограничения png, jpeg, webp	По умолчанию—
Поле`background`	Тип`string`	ТребованиеНеобязательно	Значения и ограничения auto, transparent, opaque	По умолчанию—
Поле`n`	Тип`integer`	ТребованиеНеобязательно	Значения и ограничения Минимум: 1 Максимум: 1	По умолчанию—
Поле`input_references`	Тип`array`	ТребованиеНеобязательно	Значения и ограничения Минимум элементов: 0 Максимум элементов: 10	По умолчанию—
Поле`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.26 за выходное изображение
КонфигурацияОриентировочная стоимость генерации	Шкала ставок—	Прогноз количестваОценка для одной генерации	Расчётная единица—	Плата Выход · Оценочная стоимость генерации · Оценка только для сравнения $0.26 оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации.

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': 'sourceful/riverflow-v2.5-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 sourceful/riverflow-v2.5-pro

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

/v1/images

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

sourceful/riverflow-v2.5-pro

FAQ · Sourceful: Riverflow V2.5 Pro

Какие входные данные и результаты доступны?: POST /v1/images/generations · sourceful/riverflow-v2.5-pro: text, image → image
Какие поля использует запрос?: POST /v1/images/generations · sourceful/riverflow-v2.5-pro: model, prompt, resolution, aspect_ratio, output_format, background, n, input_references, provider
Какие ограничения действуют?: POST /v1/images/generations · sourceful/riverflow-v2.5-pro: n.minimum: 1; n.maximum: 1

Sourceful: Riverflow V2.5 Pro