Sourceful: Riverflow V2 Fast

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

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

О модели

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

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

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

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

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

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

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

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

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

sourceful/riverflow-v2-fast

Sourceful /sourceful/riverflow-v2-fast

Начало

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

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

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

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

Поле	Тип	Требование	Значения и ограничения	По умолчанию
Поле`model`	Тип`string`	ТребованиеОбязательно	Значения и ограничения sourceful/riverflow-v2-fast	По умолчанию—
Поле`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	По умолчанию—
Поле`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.06 за изображение
КонфигурацияВходной референс	Шкала ставок—	Прогноз количества—	Расчётная единицаза изображение	Плата Вход · Входной референс · Оценка только для сравнения $0.4 за изображение
Конфигурациявыходное изображение	Шкала ставок—	Прогноз количества—	Расчётная единицаза выходное изображение	Плата Выход · выходное изображение · Оценка только для сравнения $0.04 за выходное изображение
КонфигурацияОриентировочная стоимость генерации	Шкала ставок—	Прогноз количестваОценка для одной генерации	Расчётная единица—	Плата Выход · Оценочная стоимость генерации · Оценка только для сравнения $0.04 оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации.

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

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

/v1/images

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

sourceful/riverflow-v2-fast

FAQ · Sourceful: Riverflow V2 Fast

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

Sourceful: Riverflow V2 Fast