Black Forest Labs: FLUX Video Upscale

FLUX Video Upscale увеличивает готовый клип, сохраняя исходник либо творчески улучшая детали. Документированный профиль предлагает масштаб 1,5×–3×, сохраняет звук и кадрирование и ограничивает длину, входное разрешение и площадь выходного кадра.

Ailoot Ultra · Видео POST /v1/videos black-forest-labs/flux-video-upscale

О модели

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

FLUX Video Upscale — сценарий сверхразрешения видео Black Forest Labs на FLUX 3. Он принимает готовый клип и возвращает увеличенный MP4, сохраняя исходные кадрирование и звук. Короткое необязательное описание направляет улучшение деталей. Два режима позволяют осмысленно выбрать близость к исходнику или более активное создание деталей, не считая каждое увеличенное изображение одинаково точной реконструкцией.

Точное или творческое улучшение

Режим выбирает creativity. Значение 0 — точный профиль с сохранением исходника; производитель рекомендует его, когда важно сохранить узнаваемость лица, продукта или фирменного материала. Значение 1 включает творческое улучшение и стоит по умолчанию. Оно активнее восстанавливает или придумывает текстуры, что полезно для сгенерированных видео, пейзажей, толпы или поверхностей, допускающих творческую детализацию.

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

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

Масштаб и площадь кадра

Документированный upscale_factor — от 1.5 до 3, по умолчанию 2. Он увеличивает разрешение с сохранением отношения сторон. Фактор и исходные размеры определяют выход, поэтому пейзажный и портретный клипы планируйте по реальным кадрам. Сначала определите целевой размер показа, затем полезное увеличение.

Точная спецификация ограничивает каждый выходной кадр 13,75 мегапиксельной единицы производителя. Одна единица равна 1 048 576 пикселям, предел — 14 417 920 пикселей, около 14,4 миллиона. Это объясняет округлённые 14,4 мегапикселя в руководстве. Большой исходник может получить меньшее увеличение, чем запрошено. Проверяйте итоговые размеры: запрос 3× не всегда утраивает каждое измерение.

Опубликованный предел исходного разрешения — 2560×1440. Сценарий увеличивает допустимый исходник к 4K и выше; более крупный вход не принимается только потому, что нужен большой выход. Подготовьте уменьшенную рабочую копию под профиль. Храните оригинал отдельно, чтобы сравнение не ограничивалось изменённым промежуточным файлом.

Короткий разборчивый исходник

Обычные рекомендации ограничивают исходник двадцатью секундами и пятьюдесятью MB. Клип передаётся URL видео или кодированным MP4. Точный справочник отмечает обработку первых двадцати секунд: небольшое превышение может быть обработано до этой точки, значительно длинный клип отклоняется. Числовой допуск не опубликован. Обрежьте нужный сегмент до двадцати секунд или короче, не полагаясь на неопределённое поведение границы.

Выберите наименее сжатую доступную версию. Артефакты сжатия ограничивают восстановление реальных деталей; творческое улучшение создаёт правдоподобную текстуру без доказательства содержания оригинала. Завершите монтаж и обрезку до увеличения. Например, закончите продуктовый план, выберите полезный интервал и увеличьте его, сохранив исходник для сравнения.

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

Сохранение и проверка клипа

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

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

Ailoot Ultra · Видео POST /v1/videos black-forest-labs/flux-video-upscale

black-forest-labs/flux-video-upscale

Black Forest Labs /black-forest-labs/flux-video-upscale

Начало

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

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

Ailoot Ultra · Видео POST /v1/videos

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

Поле	Тип	Требование	Значения и ограничения	По умолчанию
Поле`model`	Тип`string`	ТребованиеОбязательно	Значения и ограничения black-forest-labs/flux-video-upscale	По умолчанию—
Поле`input_references`	Тип`array`	ТребованиеОбязательно	Значения и ограничения Минимум элементов: 1 Максимум элементов: 1	По умолчанию—
Поле`upscale_factor`	Тип`number`	ТребованиеОбязательно	Значения и ограничения Минимум: 1,5 Максимум: 3	По умолчанию—
Поле`creativity`	Тип`integer`	ТребованиеОбязательно	Значения и ограничения 0, 1	По умолчанию—

Параметры и жизненный цикл метода

Параметр	Контракт
Параметр`content_type`	Контрактapplication/json
Параметр`required`	Контрактmodel, input_references, upscale_factor, creativity
Параметр`material_types`	Контрактtext, image, audio, video
Параметр`material_conditions`	КонтрактИспользуйте ровно один фактический URL содержимого готового видеоресурса, принадлежащего Ailoot, с возвращённой подписью. Владелец ресурса, тип и подтверждённые сохранённые байты должны соответствовать запросу.

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

GET /v1/videos/{request_id} · фактически возвращённый id или polling_url

GET /v1/videos/{request_id}/content

Тарифы

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

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

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

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

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

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

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

Конфигурация	Шкала ставок	Прогноз количества	Расчётная единица	Условия расчёта	Пикселей на мегапиксель	Плата
КонфигурацияБазовые тарифы на токены	Шкала ставокБазовая ставка	Прогноз количества—	Расчётная единица—	Условия расчёта—	Пикселей на мегапиксель—	Плата Вход · Входные токены · Оценка только для сравнения — / 1K токенов Выход · Выходные токены · Оценка только для сравнения — / 1K токенов Вход · Чтение кэша · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш, 1 час · Оценка только для сравнения — / 1K токенов
КонфигурацияЦена видео	Шкала ставок—	Прогноз количества—	Расчётная единицаза мегапиксель-секунду	Условия расчётакачество: creative	Пикселей на мегапиксель1 048 576	Плата Выход · Цена видео · Оценка только для сравнения $0.21 за мегапиксель-секунду
КонфигурацияЦена видео	Шкала ставок—	Прогноз количества—	Расчётная единицаза мегапиксель-секунду	Условия расчётаquality: precise	Пикселей на мегапиксель1 048 576	Плата Выход · Цена видео · Оценка только для сравнения $0.15 за мегапиксель-секунду
КонфигурацияОриентировочная стоимость генерации	Шкала ставок—	Прогноз количестваОценка для одной генерации	Расчётная единица—	Условия расчёта—	Пикселей на мегапиксель—	Плата Выход · Оценочная стоимость генерации · Оценка только для сравнения $0.15 оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации.

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

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

Ailoot Ultra · Видео

Используйте реальные входные данные и сохраните полный результат

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_INPUT_REFERENCES_JSON:?Set the actual documented input value}"
export AILOOT_INPUT_REFERENCES_JSON
: "${AILOOT_UPSCALE_FACTOR:?Set the actual documented input value}"
export AILOOT_UPSCALE_FACTOR
: "${AILOOT_CREATIVITY:?Set the actual documented input value}"
export AILOOT_CREATIVITY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'black-forest-labs/flux-video-upscale', 'input_references': '${ACTUAL_OWNED_INPUT_REFERENCES}', 'upscale_factor': '${ACTUAL_UPSCALE_FACTOR}', 'creativity': '${ACTUAL_CREATIVITY}'}
request['input_references']=json.loads(os.environ['AILOOT_INPUT_REFERENCES_JSON'])
request['upscale_factor']=float(os.environ['AILOOT_UPSCALE_FACTOR'])
request['creativity']=int(os.environ['AILOOT_CREATIVITY'])
Path('request.json').write_text(json.dumps(request,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o response.bin
# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.

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

Ailoot Ultra · Видео

GET /v1/videos/{request_id}
GET /v1/videos/{request_id}/content

Сохраните все готовые материалы

GET все готовые материалы

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")
urls=[]
for x in r["data"]:
    if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
    u=urljoin("https://api.ailoot.ai",x)
    z=urlsplit(u)
    if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")
    urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
  curl --fail-with-body --silent --show-error "$asset_url" \
    -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
  index=$((index + 1))
done < asset-urls.txt

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

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

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

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

Сохраните X-Client-Request-ID, X-Ailoot-Task-Id и фактически возвращённые id/polling_url. Продолжайте исходную задачу; не отправляйте запрос на создание повторно.

Поля ответа

Поле	Тип
Поле`id`	Тип
Поле`status`	Тип
Поле`data[]`	Тип
Поле`outputs[]`	Тип

Псевдонимы

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

Ailoot Ultra black-forest-labs/flux-video-upscale

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

Используйте пути методов, указанные выше.

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

black-forest-labs/flux-video-upscale

FAQ · Black Forest Labs: FLUX Video Upscale

Какие входные данные и результаты доступны?: POST /v1/videos · black-forest-labs/flux-video-upscale: text, image, audio, video → video
Какие поля использует запрос?: POST /v1/videos · black-forest-labs/flux-video-upscale: model, input_references, upscale_factor, creativity
Какие ограничения действуют?: POST /v1/videos · black-forest-labs/flux-video-upscale: upscale_factor.minimum: 1.5; upscale_factor.maximum: 3

Black Forest Labs: FLUX Video Upscale