> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ttapi.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Генерация видео с помощью FLUX 3
> Генерация видео с использованием FLUX 3 в официальном формате BFL. Поддерживаются сценарии преобразования текста в видео, изображения/ключевых кадров в видео, продолжения существующего видео и повышения качества чернового результата. Официальная документация
## OpenAPI
````yaml openapi/ru/flux.json POST /bfl/v1/flux-3-video
openapi: 3.1.0
info:
title: Документация Flux API
version: 1.0.0
description: >-
Сервис TTAPI Flux API, в настоящее время интегрирующий самую совершенную
большую видеомодель Sora2.
servers:
- url: https://api.ttapi.io
security: []
paths:
/bfl/v1/flux-3-video:
post:
description: >-
Генерация видео с использованием FLUX 3 в официальном формате BFL.
Поддерживаются сценарии преобразования текста в видео,
изображения/ключевых кадров в видео, продолжения существующего видео и
повышения качества чернового результата. Официальная документация
requestBody:
required: true
content:
application/json:
schema:
oneOf:
- title: Текст в видео
type: object
properties:
prompt:
type: string
description: Произвольное текстовое описание содержимого видео.
mode:
type: string
description: 'Допустимое значение: "t2v"'
default: t2v
aspect_ratio:
type: string
description: >-
Соотношение сторон выходного видео. Значение auto
позволяет автоматически выбрать соотношение на основе
промпта и предоставленных референсов.
default: auto
enum:
- auto
- '21:9'
- '2:1'
- '16:9'
- '4:3'
- '1:1'
- '3:4'
- '9:16'
duration:
oneOf:
- type: integer
minimum: 5
maximum: 20
- type: string
enum:
- auto
description: >-
Продолжительность видео в секундах. Поддерживается любое
целое значение от 5 до 20 секунд или значение auto для
автоматического определения продолжительности в
соответствии с содержимым.
default: auto
resolution:
type: string
description: >-
Класс разрешения видео: hd или fhd для получения
результата более высокого разрешения с последующей
обработкой видеомодулем повышения разрешения. Точные
размеры зависят от выбранного соотношения сторон.
default: hd
enum:
- hd
- fhd
version:
type: string
description: >-
Версия API. Значение `latest` используется для обращения
к текущей версии.
example: latest
enum:
- latest
generate_audio:
type: boolean
description: >-
Генерировать синхронизированную аудиодорожку вместе с
видео.
default: true
safety_tolerance:
type: integer
description: >-
Уровень допустимости при модерации входных и выходных
данных. Допустимый диапазон — от 0 до 4, где 0
соответствует наиболее строгой модерации. Независимо от
указанного уровня, для сексуального контента максимально
допускается уровень 3, а для контента, содержащего
ненависть, — уровень 2. В зависимости от контекстных
сигналов безопасности система может дополнительно
ужесточить запрошенный уровень.
minimum: 0
maximum: 4
default: 2
draft:
type: boolean
description: >-
Режим черновика: генерирует быстрое предварительное
видео и возвращает URL для загрузки draft_cache в
результате. После загрузки этого пакета его можно
передать в последующем запросе для создания
полноразмерной версии того же результата.
default: false
webhook_url:
type: string
description: >-
URL асинхронного callback-уведомления TTAPI. В
первоначальном ответе возвращается `jobId`; итоговый
результат видео можно получить через данный callback или
через endpoint Flux для получения результата.
required:
- mode
- prompt
- title: Изображение в видео
description: >-
Продолжение на основе изображений: предоставленные
изображения используются в качестве кадров видео. Одно
изображение задаёт начальный кадр; два изображения задают
начальный и конечный кадры; при наличии нескольких
изображений первое используется в качестве начального кадра,
последнее — в качестве конечного, а остальные равномерно
распределяются между ними. Для точного управления временными
позициями можно передавать пары [секунда, изображение], при
этом каждое изображение будет соответствовать указанному
моменту времени.
type: object
properties:
prompt:
type: string
description: Произвольное текстовое описание содержимого видео.
mode:
type: string
description: 'Допустимое значение: "i2v"'
default: i2v
keyframes:
oneOf:
- type: string
- type: array
description: >-
Предоставленные изображения используются в качестве
кадров видео; каждое изображение может быть указано в
виде http(s)-URL или base64, всего поддерживается от
одного до десяти изображений. При обычной передаче
изображений одно изображение задаёт начало видео, два —
начало и конец, а при наличии трёх и более изображений
первое задаёт начало, последнее — конец, а остальные
равномерно распределяются между ними (для 3 и более
изображений необходимо явно указать продолжительность).
Для точного управления временем можно передавать пары
[секунда, изображение] в хронологическом порядке,
например [[0, "..."], [3.5, "..."]]. Каждое изображение
будет использоваться в качестве кадра в указанный момент
времени. При значении duration: "auto" продолжительность
видео определяется по времени последней пары с
округлением вверх, максимальная продолжительность — 20
секунд.
aspect_ratio:
type: string
description: >-
Соотношение сторон выходного видео. Значение auto
позволяет автоматически выбрать соотношение на основе
промпта и предоставленных референсов.
default: auto
enum:
- auto
- '21:9'
- '2:1'
- '16:9'
- '4:3'
- '1:1'
- '3:4'
- '9:16'
duration:
oneOf:
- type: integer
minimum: 5
maximum: 20
- type: string
enum:
- auto
description: >-
Продолжительность видео в секундах. Поддерживается любое
целое значение от 5 до 20 секунд или значение auto для
автоматического определения продолжительности в
соответствии с содержимым.
default: auto
resolution:
type: string
description: >-
Класс разрешения видео: hd или fhd для получения
результата более высокого разрешения с последующей
обработкой видеомодулем повышения разрешения. Точные
размеры зависят от выбранного соотношения сторон.
default: hd
enum:
- hd
- fhd
version:
type: string
description: >-
Версия API. Значение `latest` используется для обращения
к текущей версии.
example: latest
enum:
- latest
generate_audio:
type: boolean
description: >-
Генерировать синхронизированную аудиодорожку вместе с
видео.
default: true
safety_tolerance:
type: integer
description: >-
Уровень допустимости при модерации входных и выходных
данных. Допустимый диапазон — от 0 до 4, где 0
соответствует наиболее строгой модерации. Независимо от
указанного уровня, для сексуального контента максимально
допускается уровень 3, а для контента, содержащего
ненависть, — уровень 2. В зависимости от контекстных
сигналов безопасности система может дополнительно
ужесточить запрошенный уровень.
minimum: 0
maximum: 4
default: 2
draft:
type: boolean
description: >-
Режим черновика: генерирует быстрое предварительное
видео и возвращает URL для загрузки draft_cache в
результате. После загрузки этого пакета его можно
передать в последующем запросе для создания
полноразмерной версии того же результата.
default: false
webhook_url:
type: string
description: >-
URL асинхронного callback-уведомления TTAPI. В
первоначальном ответе возвращается `jobId`; итоговый
результат видео можно получить через данный callback или
через endpoint Flux для получения результата.
required:
- mode
- prompt
- keyframes
- title: Продолжение видео
description: >-
Продолжение видео: сгенерированный видеоклип продолжается с
последних кадров предоставленного исходного видео.
type: object
properties:
prompt:
type: string
description: Произвольное текстовое описание содержимого видео.
mode:
type: string
description: 'Допустимое значение: "v2v"'
default: v2v
start_video:
type: string
description: >-
Исходное видео для продолжения. Может быть указано в
виде http(s)-URL или base64-кодированного MP4-файла.
Сгенерированный видеоклип будет продолжен с последних
кадров исходного видео.
aspect_ratio:
type: string
description: >-
Соотношение сторон выходного видео. Значение auto
позволяет автоматически выбрать соотношение на основе
промпта и предоставленных референсов.
default: auto
enum:
- auto
- '21:9'
- '2:1'
- '16:9'
- '4:3'
- '1:1'
- '3:4'
- '9:16'
duration:
oneOf:
- type: integer
minimum: 5
maximum: 20
- type: string
enum:
- auto
description: >-
Продолжительность видео в секундах. Поддерживается любое
целое значение от 5 до 20 секунд или значение auto для
автоматического определения продолжительности в
соответствии с содержимым.
default: auto
resolution:
type: string
description: >-
Класс разрешения видео: hd или fhd для получения
результата более высокого разрешения с последующей
обработкой видеомодулем повышения разрешения. Точные
размеры зависят от выбранного соотношения сторон.
default: hd
enum:
- hd
- fhd
version:
type: string
description: >-
Версия API. Значение `latest` используется для обращения
к текущей версии.
example: latest
enum:
- latest
generate_audio:
type: boolean
description: >-
Генерировать синхронизированную аудиодорожку вместе с
видео.
default: true
safety_tolerance:
type: integer
description: >-
Уровень допустимости при модерации входных и выходных
данных. Допустимый диапазон — от 0 до 4, где 0
соответствует наиболее строгой модерации. Независимо от
указанного уровня, для сексуального контента максимально
допускается уровень 3, а для контента, содержащего
ненависть, — уровень 2. В зависимости от контекстных
сигналов безопасности система может дополнительно
ужесточить запрошенный уровень.
minimum: 0
maximum: 4
default: 2
draft:
type: boolean
description: >-
Режим черновика: генерирует быстрое предварительное
видео и возвращает URL для загрузки draft_cache в
результате. После загрузки этого пакета его можно
передать в последующем запросе для создания
полноразмерной версии того же результата.
default: false
webhook_url:
type: string
description: >-
URL асинхронного callback-уведомления TTAPI. В
первоначальном ответе возвращается `jobId`; итоговый
результат видео можно получить через данный callback или
через endpoint Flux для получения результата.
required:
- mode
- prompt
- start_video
- title: Улучшение черновика
description: >-
Рендеринг предыдущей генерации в полном качестве на основе
черновика. Пакет содержит все параметры исходной генерации,
включая исходный режим, промпт, seed и медиаданные условий
генерации, поэтому вызывающей стороне необходимо выбрать
только выходное разрешение.
type: object
properties:
mode:
type: string
description: 'Допустимое значение: "draft_enhance"'
default: draft_enhance
draft_cache:
type: string
description: >-
Зашифрованный пакет draft-cache, полученный в результате
предыдущей генерации в режиме черновика. Основной
вариант использования — base64-кодированное содержимое
файла .bin, загруженного по URL draft_cache из
предыдущего результата. Также допускается передача
http(s)-URL для повторного запуска в течение срока
действия URL загрузки. При использовании пакета
промежуточный этап обработки пропускается, а исходный
вызов FLUX воспроизводится в полном качестве; исходные
входные данные уже содержатся внутри пакета.
resolution:
type: string
description: >-
Класс разрешения улучшенного видео: fhd (по умолчанию)
выполняет финальную обработку с использованием
видеомодуля повышения разрешения, hd возвращает
результат без этого этапа. В обоих случаях сама
воспроизводимая генерация полностью идентична;
различается только финальный этап обработки.
default: fhd
enum:
- hd
- fhd
safety_tolerance:
type: integer
description: >-
Уровень допустимости при модерации входных и выходных
данных. Допустимый диапазон — от 0 до 4, где 0
соответствует наиболее строгой модерации. Независимо от
указанного уровня, для сексуального контента максимально
допускается уровень 3, а для контента, содержащего
ненависть, — уровень 2. В зависимости от контекстных
сигналов безопасности система может дополнительно
ужесточить запрошенный уровень.
minimum: 0
maximum: 4
default: 2
webhook_url:
type: string
description: >-
URL асинхронного callback-уведомления TTAPI. В
первоначальном ответе возвращается `jobId`; итоговый
результат видео можно получить через данный callback или
через endpoint Flux для получения результата.
required:
- mode
- draft_cache
responses:
'200':
$ref: '#/components/responses/SuccessResponse'
'400':
$ref: '#/components/responses/400Response'
'401':
$ref: '#/components/responses/401Response'
security:
- CustomApiKey: []
components:
responses:
SuccessResponse:
description: Запрос выполнен успешно
content:
application/json:
schema:
type: object
properties:
status:
type: string
example: SUCCESS
message:
type: string
example: success
data:
type: object
example:
jobId: jobId
required:
- status
- message
- data
400Response:
description: Ошибка параметров
content:
application/json:
schema:
type: object
properties:
status:
type: string
example: FAILED
message:
type: string
example: '"prompt" cannot be empty.'
data:
type: object
required:
- status
- message
401Response:
description: Ошибка авторизации
content:
application/json:
schema:
type: object
properties:
status:
type: string
example: FAILED
message:
type: string
example: Wrong TT-API-KEY or email is not activated.
required:
- status
- message
securitySchemes:
CustomApiKey:
type: apiKey
in: header
name: TT-API-KEY
description: >-
Вы можете получить API-ключ в панель управления TTAPI.
````