Общая документация Public API · API-ключ можно создать в настройках аккаунта
Flux 3 Video делает ролик со звуком длиной от 5 до 20 секунд: по текстовому описанию или по картинкам. Голоса, шумы и фон модель создаёт вместе с изображением, отдельная озвучка не нужна. Задание можно писать по-русски, и герои тоже говорят по-русски.
Чаще всего модель берут для коротких сцен с репликой героя, роликов товара из пары фотографий, атмосферных фонов со звуком и переходов между двумя состояниями: лето и зима, пустая комната и обставленная, эскиз и готовый рисунок.
Каждый вызов создаёт асинхронную операцию. После запуска сохраните id и проверяйте статус отдельным запросом.
POST /api/v1/operationsAuthorization: Bearer brth_...id операции и стартовый статус queued.Сценарий задаёт параметр flux_3_video_generation_type:
flux_3_video_generation_type | Что делает | Файлы |
|---|---|---|
image | Видео из изображений. Одна картинка становится первым кадром, несколько модель проходит по порядку, как ключевые кадры | image_urls - от 1 до 10 ссылок |
text | Видео только по описанию | - |
Если flux_3_video_generation_type не передать, используется image, и тогда нужна хотя бы одна картинка. Для ролика по описанию явно передайте text.
{
"tool": "flux-3-video",
"input": {
"...": "..."
}
}
tool - slug нейросети, всегда "flux-3-video".input - параметры запуска. Все поля передаются прямо внутри этого объекта, без дополнительной вложенности.prompt, duration, billing_tier, aspect_ratio, audio. Поле image_urls нужно только в сценарии image.| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
flux_3_video_generation_type | enum | Да | Сценарий: image - видео из изображений, text - видео из текста. Если не указать - image. |
prompt | string | Да | Задание: кто в кадре и где, что происходит, что говорят герои, как движется камера и что слышно. От 2 до 4000 символов. |
image_urls | string[] (url) | Да, для image | Массив ссылок на картинки, от 1 до 10 штук: jpg, jpeg, png, webp. Порядок важен: первая ссылка - начало ролика, дальше модель идёт по очереди. В сценарии text поле не учитывается. |
duration | number | Да | Длительность ролика в секундах, целое число от 5 до 20. Если не указать - 5. Оплата за каждую секунду. |
billing_tier | enum | Да | Качество: draft - черновик для проб, самый дешёвый, hd - для телефона и соцсетей, fhd - больше пикселей для большого экрана. Если не указать - hd. От качества зависит цена за секунду. |
aspect_ratio | enum | Да | Соотношение сторон: auto, 21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16. Если не указать - auto. С картинками auto берёт их форму, для сценария text лучше задать формат самому. |
audio | boolean | Нет | Добавить звуковую дорожку: речь, шумы, фон. По умолчанию true. На цену не влияет. |
Все ссылки на файлы - только внешние http/https URL с расширениями из таблицы.
Ролик только по описанию, без картинок. Здесь черновик на 5 секунд - самый дешёвый способ проверить сцену.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "flux-3-video",
"input": {
"flux_3_video_generation_type": "text",
"prompt": "Рассвет на лесном озере, над водой стелется туман. В лодке двое рыбаков. Поплавок дёргается, пожилой рыбак говорит по-русски: «Тише. Клюёт». Камера неподвижна, сбоку от лодки. Звук: голос, плеск воды, далёкая кукушка, без музыки. Без субтитров",
"duration": 5,
"billing_tier": "draft",
"aspect_ratio": "16:9",
"audio": true
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'flux-3-video',
input: {
flux_3_video_generation_type: 'text',
prompt: 'Рассвет на лесном озере, над водой стелется туман. В лодке двое рыбаков. Поплавок дёргается, пожилой рыбак говорит по-русски: «Тише. Клюёт». Камера неподвижна, сбоку от лодки. Звук: голос, плеск воды, далёкая кукушка, без музыки. Без субтитров',
duration: 5,
billing_tier: 'draft',
aspect_ratio: '16:9',
audio: true,
},
}),
})
const data = await response.json()
console.log(data.id, data.status, data.cost)
import requests
response = requests.post(
'https://bratuha.ru/api/v1/operations',
headers={
'Authorization': 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
json={
'tool': 'flux-3-video',
'input': {
'flux_3_video_generation_type': 'text',
'prompt': 'Рассвет на лесном озере, над водой стелется туман. В лодке двое рыбаков. Поплавок дёргается, пожилой рыбак говорит по-русски: «Тише. Клюёт». Камера неподвижна, сбоку от лодки. Звук: голос, плеск воды, далёкая кукушка, без музыки. Без субтитров',
'duration': 5,
'billing_tier': 'draft',
'aspect_ratio': '16:9',
'audio': True,
},
},
timeout=60,
)
print(response.status_code)
print(response.json())
Две картинки - начало и конец ролика: модель строит переход от первой ко второй. В задании опишите, что меняется по шагам, и отдельно - что должно остаться на месте. Если нужна одна стартовая картинка, передайте массив из одной ссылки.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "flux-3-video",
"input": {
"flux_3_video_generation_type": "image",
"prompt": "Переход от первой картинки ко второй: летний закат сменяется зимним вечером, начинается снегопад, снег ложится на мостовую и крыши, в окнах загорается свет. Не меняются: вывеска пекарни и кот на тротуаре. Камера неподвижна. Звук: птицы постепенно сменяются тихим зимним ветром, без музыки",
"image_urls": [
"https://cdn.example.com/street-summer-1.jpg",
"https://cdn.example.com/street-winter-2.png"
],
"duration": 10,
"billing_tier": "hd",
"aspect_ratio": "auto",
"audio": true
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'flux-3-video',
input: {
flux_3_video_generation_type: 'image',
prompt: 'Переход от первой картинки ко второй: летний закат сменяется зимним вечером, начинается снегопад, снег ложится на мостовую и крыши, в окнах загорается свет. Не меняются: вывеска пекарни и кот на тротуаре. Камера неподвижна. Звук: птицы постепенно сменяются тихим зимним ветром, без музыки',
image_urls: [
'https://cdn.example.com/street-summer-1.jpg',
'https://cdn.example.com/street-winter-2.png',
],
duration: 10,
billing_tier: 'hd',
aspect_ratio: 'auto',
audio: true,
},
}),
})
const data = await response.json()
console.log(data.id, data.status, data.cost)
import requests
response = requests.post(
'https://bratuha.ru/api/v1/operations',
headers={
'Authorization': 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
json={
'tool': 'flux-3-video',
'input': {
'flux_3_video_generation_type': 'image',
'prompt': 'Переход от первой картинки ко второй: летний закат сменяется зимним вечером, начинается снегопад, снег ложится на мостовую и крыши, в окнах загорается свет. Не меняются: вывеска пекарни и кот на тротуаре. Камера неподвижна. Звук: птицы постепенно сменяются тихим зимним ветром, без музыки',
'image_urls': [
'https://cdn.example.com/street-summer-1.jpg',
'https://cdn.example.com/street-winter-2.png',
],
'duration': 10,
'billing_tier': 'hd',
'aspect_ratio': 'auto',
'audio': True,
},
},
timeout=60,
)
print(response.status_code)
print(response.json())
Три фотографии товара по очереди, вертикальный кадр 9:16 и максимальное качество.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "flux-3-video",
"input": {
"flux_3_video_generation_type": "image",
"prompt": "Керамическая кружка на деревянном столе: камера медленно облетает её, утренний свет из окна, пар поднимается над кофе. Звук: тихая кофейня, звон ложки, без музыки",
"image_urls": [
"https://cdn.example.com/mug-front-1.jpg",
"https://cdn.example.com/mug-side-2.jpg",
"https://cdn.example.com/mug-top-3.webp"
],
"duration": 8,
"billing_tier": "fhd",
"aspect_ratio": "9:16",
"audio": true
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'flux-3-video',
input: {
flux_3_video_generation_type: 'image',
prompt: 'Керамическая кружка на деревянном столе: камера медленно облетает её, утренний свет из окна, пар поднимается над кофе. Звук: тихая кофейня, звон ложки, без музыки',
image_urls: [
'https://cdn.example.com/mug-front-1.jpg',
'https://cdn.example.com/mug-side-2.jpg',
'https://cdn.example.com/mug-top-3.webp',
],
duration: 8,
billing_tier: 'fhd',
aspect_ratio: '9:16',
audio: true,
},
}),
})
const data = await response.json()
console.log(data.id, data.status, data.cost)
import requests
response = requests.post(
'https://bratuha.ru/api/v1/operations',
headers={
'Authorization': 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
json={
'tool': 'flux-3-video',
'input': {
'flux_3_video_generation_type': 'image',
'prompt': 'Керамическая кружка на деревянном столе: камера медленно облетает её, утренний свет из окна, пар поднимается над кофе. Звук: тихая кофейня, звон ложки, без музыки',
'image_urls': [
'https://cdn.example.com/mug-front-1.jpg',
'https://cdn.example.com/mug-side-2.jpg',
'https://cdn.example.com/mug-top-3.webp',
],
'duration': 8,
'billing_tier': 'fhd',
'aspect_ratio': '9:16',
'audio': True,
},
},
timeout=60,
)
print(response.status_code)
print(response.json())
{
"id": "op_uuid-123",
"status": "queued",
"tool": "flux-3-video",
"cost": 200,
"balance_after": 300,
"created_at": "2026-10-19T12:00:00.000000+00:00"
}
{
"id": "op_uuid-123",
"status": "completed",
"tool": "flux-3-video",
"cost": 200,
"created_at": "2026-10-19T12:00:00.000000+00:00",
"completed_at": "2026-10-19T12:02:10.000000+00:00",
"result": {
"type": "video",
"urls": [
"https://storage.bratuha.ru/results/flux-3-video/video-1.mp4"
]
},
"error_message": null
}
{
"id": "op_uuid-123",
"status": "failed",
"tool": "flux-3-video",
"cost": 200,
"created_at": "2026-10-19T12:00:00.000000+00:00",
"completed_at": "2026-10-19T12:00:40.000000+00:00",
"result": null,
"error_message": "Ваш запрос не прошел модерацию."
}
Если операция завершилась ошибкой, деньги возвращаются на баланс автоматически.
Сохраните id из ответа на создание и проверяйте операцию по нему:
GET /api/v1/operations/{id}
curl -H "Authorization: Bearer brth_ваш_ключ" \
https://bratuha.ru/api/v1/operations/op_uuid-123
async function waitForResult(id: string) {
while (true) {
const response = await fetch(`https://bratuha.ru/api/v1/operations/${id}`, {
headers: { Authorization: 'Bearer brth_ваш_ключ' },
})
const operation = await response.json()
if (operation.status === 'completed' || operation.status === 'failed') {
return operation
}
await new Promise((resolve) => setTimeout(resolve, 15000))
}
}
Пятисекундный ролик обычно готов за 1-2 минуты, длинные ролики в FHD занимают больше. Одну операцию можно опрашивать не чаще раза в секунду, разумный интервал - 10-15 секунд.
После завершения в result приходит одно видео:
{
"type": "video",
"urls": [
"https://storage.bratuha.ru/results/flux-3-video/video-1.mp4"
]
}
type - всегда "video".urls - массив с одной ссылкой на MP4, 24 кадра в секунду.duration. При audio: true в видео есть звуковая дорожка.draft и hd дают кадр одного размера (для 16:9 это 1280x704), у hd чётче мелкие детали. fhd примерно в полтора раза крупнее по каждой стороне.Ссылку лучше сразу скачать к себе: файлы результатов хранятся ограниченное время.
Цена считается за секунду ролика и зависит только от качества. Сценарий, количество картинок, aspect_ratio и audio на цену не влияют.
| Качество | За секунду | 5 сек. | 10 сек. | 15 сек. | 20 сек. |
|---|---|---|---|---|---|
draft | 8 ₽ | 40 ₽ | 80 ₽ | 120 ₽ | 160 ₽ |
hd | 20 ₽ | 100 ₽ | 200 ₽ | 300 ₽ | 400 ₽ |
fhd | 32 ₽ | 160 ₽ | 320 ₽ | 480 ₽ | 640 ₽ |
Итог = ставка за секунду × duration. Самый дешёвый запуск - 5 секунд в draft за 40 ₽, запрос с настройками по умолчанию (hd, 5 секунд) стоит 100 ₽. Сумма списывается при создании операции и видна в поле cost.
Чтобы не потратить больше, чем планировали, передайте в теле запроса max_price рядом с tool и input: если цена запуска выше, сервер вернёт ошибку до списания.
POST /api/v1/operations сам по себе не идемпотентен: каждый повторный запрос создаёт новую платную операцию. Чтобы безопасно повторять запрос после сетевой ошибки, передайте UUID в заголовке Idempotency-Key: повтор того же запроса в течение 24 часов вернёт исходную операцию без нового списания.queued, результат забирайте через GET /api/v1/operations/{id}.http/https URL с расширениями jpg, jpeg, png, webp. Адреса localhost и внутренних сетей не принимаются, файлы должны открываться без авторизации.image и text. Доводка готового черновика до HD или FHD работает с роликом из вашей истории и есть только в форме на сайте.draft на 5 секундах, а длительность и качество поднимайте, когда она уже получилась. Новый запуск в hd или fhd даёт новый ролик, а не улучшенную копию черновика.