Sourceful: Riverflow V2.5 Fast

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

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

О модели

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

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

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

Собственные критерии оценки в семействе 2.5 позволяют выразить в рубрике, что делает вариант полезным. Укажите такие критерии, как узнаваемая упаковка, читаемые надписи, согласованное освещение и удобная обрезка. Отделяйте рубрику от инструкции генерации: одна описывает нужное изображение, другая задаёт подход к его проверке. На раннем этапе поиска полезен более низкий уровень усилий на рассуждения; затем дополнительную проверку можно направить на критерии, которым первый вариант не удовлетворил.

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

В процессе 2.5 Font Control может использовать до двух переданных файлов пользовательских шрифтов. Укажите точный заголовок и подпись, их расположение и роль каждого шрифта. Небольшое число чётко определённых текстовых блоков облегчает оценку иерархии по сравнению с плотным полотном, содержащим несколько противоречащих друг другу указаний. Проверяйте орфографию, числа, переносы строк и насыщенность в полученном изображении при том размере, в котором оно будет использоваться. Изображение — готовый визуальный артефакт, а не редактируемый файл вёрстки или работающий интерфейс.

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

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

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

sourceful/riverflow-v2.5-fast

Sourceful /sourceful/riverflow-v2.5-fast

Начало

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

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

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

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

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

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-fast', '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-fast

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

/v1/images

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

sourceful/riverflow-v2.5-fast

FAQ · Sourceful: Riverflow V2.5 Fast

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

Sourceful: Riverflow V2.5 Fast