Создаёт видео со звуком по тексту, изображению и референсам, редактирует и продлевает ролики. Цена зависит от разрешения: 480p — 10 ₽/сек., 720p — 22 ₽/сек.; с видео на входе — 6 и 14 ₽ за каждую секунду входного и готового видео.
Общая документация Public API · API-ключ можно создать в настройках аккаунта
Seedance 2.5 Flash - быстрая и недорогая версия Seedance 2.5. Она делает ролики со звуком по тексту, по изображению и по референсам, а ещё правит и продлевает готовые видео. Подходит для коротких роликов в соцсети, превью идей и массовой генерации, когда не нужно разрешение выше 720p.
Режимы вызова, описанные ниже:
text - видео только по текстовому описанию;image - видео из изображения: оживить один кадр или сделать переход между первым и конечным кадром;references - видео по смешанным референсам: изображения, видео и аудио одновременно;edit - правка готового видео по заданию с сохранением движения и длины;extend - продолжение готового ролика: нейросеть дописывает, что было дальше.Каждый вызов создаёт асинхронную операцию. Сразу после запроса API возвращает id и стартовый статус, а готовый ролик нужно получить отдельной проверкой статуса.
POST /api/v1/operationsAuthorization: Bearer brth_...id и стартовый статус.Режим вызова выбирается параметром seedance_2_5_flash_generation_type: text, image, references, edit или extend.
{
"tool": "seedance-2-5-flash",
"input": {
"seedance_2_5_flash_generation_type": "text",
"...": "..."
}
}
tool - slug нейросети, всегда "seedance-2-5-flash".input - параметры конкретного запуска.input зависит от выбранного seedance_2_5_flash_generation_type.input, без дополнительной вложенности.| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
seedance_2_5_flash_generation_type | enum | Да | Режим генерации. Варианты: text (видео из текста), image (видео из изображения), references (видео по референсам), edit (редактирование видео), extend (продление видео). Определяет, какие остальные поля нужно передавать. |
prompt | string | Да | Текстовое задание: сцена, действие, стиль, движение камеры и звук. В режиме edit - что изменить в исходном видео, в extend - что происходит дальше. Ссылки на файлы - @Image1, @Video1, @Audio1. От 2 до 20000 символов. |
first_frame_url | string (url) | Да | URL первого кадра. Обязателен только в режиме image. До 30 МБ. |
last_frame_url | string (url) | Нет | URL конечного кадра для перехода. Только в режиме image. До 30 МБ. |
reference_image_urls | string[] (url) | Нет | Референсные изображения для режима references. До 10 изображений, каждое до 30 МБ. |
video_urls | string[] (url) | Нет | Видео-референсы для режима references. До 5 видео, каждое до 200 МБ, длительность одного файла от 2 до 30 секунд, суммарно до 30 секунд. Секунды видео-референсов тоже входят в цену - подробности в разделе «Ценообразование». |
audio_urls | string[] (url) | Нет | Аудио-референсы для режима references. До 5 файлов, каждый до 15 МБ, длительность одного файла от 2 до 30 секунд, суммарно до 30 секунд. |
edit_video_url | string (url) | Да | URL видео, которое нужно изменить. Обязателен только в режиме edit. MP4 или MOV, от 4 до 30 секунд, до 200 МБ. Длительность сервер определяет сам по файлу, она входит в цену. |
edit_image_urls |
В режиме references нужно передать хотя бы один референс - reference_image_urls, video_urls или audio_urls. Если не передать ни одного, операция не создаётся.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "seedance-2-5-flash",
"input": {
"seedance_2_5_flash_generation_type": "text",
"prompt": "Кинематографичный вид ночного мегаполиса с высоты: неоновые вывески, лёгкий туман, плавное движение камеры вперёд, отражения огней в мокром асфальте",
"size": "16:9",
"resolution": "720p",
"duration": 6,
"generate_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: 'seedance-2-5-flash',
input: {
"seedance_2_5_flash_generation_type": "text",
"prompt": "Кинематографичный вид ночного мегаполиса с высоты: неоновые вывески, лёгкий туман, плавное движение камеры вперёд, отражения огней в мокром асфальте",
"size": "16:9",
"resolution": "720p",
"duration": 6,
"generate_audio": true
},
}),
})
const data = await response.json()
console.log(data)
import requests
response = requests.post(
"https://bratuha.ru/api/v1/operations",
headers={
"Authorization": "Bearer brth_ваш_ключ",
"Content-Type": "application/json",
},
json={
"tool": "seedance-2-5-flash",
"input": {
"seedance_2_5_flash_generation_type": "text",
"prompt": "Кинематографичный вид ночного мегаполиса с высоты: неоновые вывески, лёгкий туман, плавное движение камеры вперёд, отражения огней в мокром асфальте",
"size": "16:9",
"resolution": "720p",
"duration": 6,
"generate_audio": True
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
Конечный кадр необязателен: с одним first_frame_url нейросеть оживит картинку, с двумя кадрами - сделает плавный переход. Пропорции ролика берутся из первого кадра, поэтому size в этом режиме не передаётся.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "seedance-2-5-flash",
"input": {
"seedance_2_5_flash_generation_type": "image",
"prompt": "Плавный переход между двумя кадрами: героиня разворачивается к окну, свет и цвет остаются прежними, камера почти статична",
"first_frame_url": "https://cdn.example.com/source-first-frame-1.jpg",
"last_frame_url": "https://cdn.example.com/source-last-frame-1.jpg",
"resolution": "720p",
"duration": 5,
"generate_audio": false
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'seedance-2-5-flash',
input: {
"seedance_2_5_flash_generation_type": "image",
"prompt": "Плавный переход между двумя кадрами: героиня разворачивается к окну, свет и цвет остаются прежними, камера почти статична",
"first_frame_url": "https://cdn.example.com/source-first-frame-1.jpg",
"last_frame_url": "https://cdn.example.com/source-last-frame-1.jpg",
"resolution": "720p",
"duration": 5,
"generate_audio": false
},
}),
})
const data = await response.json()
console.log(data)
import requests
response = requests.post(
"https://bratuha.ru/api/v1/operations",
headers={
"Authorization": "Bearer brth_ваш_ключ",
"Content-Type": "application/json",
},
json={
"tool": "seedance-2-5-flash",
"input": {
"seedance_2_5_flash_generation_type": "image",
"prompt": "Плавный переход между двумя кадрами: героиня разворачивается к окну, свет и цвет остаются прежними, камера почти статична",
"first_frame_url": "https://cdn.example.com/source-first-frame-1.jpg",
"last_frame_url": "https://cdn.example.com/source-last-frame-1.jpg",
"resolution": "720p",
"duration": 5,
"generate_audio": False
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
В prompt на файлы ссылаются как @Image1, @Image2, @Video1 и так далее - по порядку в массивах.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "seedance-2-5-flash",
"input": {
"seedance_2_5_flash_generation_type": "references",
"prompt": "Собери сцену по референсам: поза и ракурс героя как в @Video1, одежда как на @Image1, фон как на @Image2",
"reference_image_urls": [
"https://cdn.example.com/source-image-1.jpg",
"https://cdn.example.com/source-image-2.jpg"
],
"video_urls": [
"https://cdn.example.com/source-video-1.mp4",
"https://cdn.example.com/source-video-2.mov"
],
"size": "9:16",
"resolution": "480p",
"duration": 8,
"generate_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: 'seedance-2-5-flash',
input: {
"seedance_2_5_flash_generation_type": "references",
"prompt": "Собери сцену по референсам: поза и ракурс героя как в @Video1, одежда как на @Image1, фон как на @Image2",
"reference_image_urls": [
"https://cdn.example.com/source-image-1.jpg",
"https://cdn.example.com/source-image-2.jpg"
],
"video_urls": [
"https://cdn.example.com/source-video-1.mp4",
"https://cdn.example.com/source-video-2.mov"
],
"size": "9:16",
"resolution": "480p",
"duration": 8,
"generate_audio": true
},
}),
})
const data = await response.json()
console.log(data)
import requests
response = requests.post(
"https://bratuha.ru/api/v1/operations",
headers={
"Authorization": "Bearer brth_ваш_ключ",
"Content-Type": "application/json",
},
json={
"tool": "seedance-2-5-flash",
"input": {
"seedance_2_5_flash_generation_type": "references",
"prompt": "Собери сцену по референсам: поза и ракурс героя как в @Video1, одежда как на @Image1, фон как на @Image2",
"reference_image_urls": [
"https://cdn.example.com/source-image-1.jpg",
"https://cdn.example.com/source-image-2.jpg"
],
"video_urls": [
"https://cdn.example.com/source-video-1.mp4",
"https://cdn.example.com/source-video-2.mov"
],
"size": "9:16",
"resolution": "480p",
"duration": 8,
"generate_audio": True
},
},
timeout=30,
)
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": "seedance-2-5-flash",
"input": {
"seedance_2_5_flash_generation_type": "references",
"prompt": "Персонаж поёт и двигается в такт голосу из @Audio1, на фоне звучит музыка из @Audio2, тёплый вечерний свет",
"audio_urls": [
"https://cdn.example.com/source-audio-1.mp3",
"https://cdn.example.com/source-audio-2.wav"
],
"size": "1:1",
"resolution": "480p",
"duration": 6
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'seedance-2-5-flash',
input: {
"seedance_2_5_flash_generation_type": "references",
"prompt": "Персонаж поёт и двигается в такт голосу из @Audio1, на фоне звучит музыка из @Audio2, тёплый вечерний свет",
"audio_urls": [
"https://cdn.example.com/source-audio-1.mp3",
"https://cdn.example.com/source-audio-2.wav"
],
"size": "1:1",
"resolution": "480p",
"duration": 6
},
}),
})
const data = await response.json()
console.log(data)
import requests
response = requests.post(
"https://bratuha.ru/api/v1/operations",
headers={
"Authorization": "Bearer brth_ваш_ключ",
"Content-Type": "application/json",
},
json={
"tool": "seedance-2-5-flash",
"input": {
"seedance_2_5_flash_generation_type": "references",
"prompt": "Персонаж поёт и двигается в такт голосу из @Audio1, на фоне звучит музыка из @Audio2, тёплый вечерний свет",
"audio_urls": [
"https://cdn.example.com/source-audio-1.mp3",
"https://cdn.example.com/source-audio-2.wav"
],
"size": "1:1",
"resolution": "480p",
"duration": 6
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
Исходный ролик передаётся в edit_video_url. size и duration не передаются: результат будет той же длины и с теми же пропорциями. Изображения и аудио для правки - в edit_image_urls и edit_audio_urls, в prompt на них ссылаются как @Image1, @Audio1.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "seedance-2-5-flash",
"input": {
"seedance_2_5_flash_generation_type": "edit",
"prompt": "Замени куртку героя на куртку с @Image1, движение, фон и свет оставь как в исходном видео",
"edit_video_url": "https://cdn.example.com/source-video-1.mp4",
"edit_image_urls": [
"https://cdn.example.com/source-image-1.jpg",
"https://cdn.example.com/source-image-2.jpg"
],
"resolution": "720p",
"generate_audio": false
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'seedance-2-5-flash',
input: {
"seedance_2_5_flash_generation_type": "edit",
"prompt": "Замени куртку героя на куртку с @Image1, движение, фон и свет оставь как в исходном видео",
"edit_video_url": "https://cdn.example.com/source-video-1.mp4",
"edit_image_urls": [
"https://cdn.example.com/source-image-1.jpg",
"https://cdn.example.com/source-image-2.jpg"
],
"resolution": "720p",
"generate_audio": false
},
}),
})
const data = await response.json()
console.log(data)
import requests
response = requests.post(
"https://bratuha.ru/api/v1/operations",
headers={
"Authorization": "Bearer brth_ваш_ключ",
"Content-Type": "application/json",
},
json={
"tool": "seedance-2-5-flash",
"input": {
"seedance_2_5_flash_generation_type": "edit",
"prompt": "Замени куртку героя на куртку с @Image1, движение, фон и свет оставь как в исходном видео",
"edit_video_url": "https://cdn.example.com/source-video-1.mp4",
"edit_image_urls": [
"https://cdn.example.com/source-image-1.jpg",
"https://cdn.example.com/source-image-2.jpg"
],
"resolution": "720p",
"generate_audio": False
},
},
timeout=30,
)
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": "seedance-2-5-flash",
"input": {
"seedance_2_5_flash_generation_type": "extend",
"prompt": "Гончар отставляет готовый горшок в сторону, вытирает руки о фартук и встаёт из-за круга. Камера медленно отъезжает",
"extend_video_url": "https://cdn.example.com/source-video-1.mp4",
"extend_duration": 5,
"resolution": "720p",
"generate_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: 'seedance-2-5-flash',
input: {
"seedance_2_5_flash_generation_type": "extend",
"prompt": "Гончар отставляет готовый горшок в сторону, вытирает руки о фартук и встаёт из-за круга. Камера медленно отъезжает",
"extend_video_url": "https://cdn.example.com/source-video-1.mp4",
"extend_duration": 5,
"resolution": "720p",
"generate_audio": true
},
}),
})
const data = await response.json()
console.log(data)
import requests
response = requests.post(
"https://bratuha.ru/api/v1/operations",
headers={
"Authorization": "Bearer brth_ваш_ключ",
"Content-Type": "application/json",
},
json={
"tool": "seedance-2-5-flash",
"input": {
"seedance_2_5_flash_generation_type": "extend",
"prompt": "Гончар отставляет готовый горшок в сторону, вытирает руки о фартук и встаёт из-за круга. Камера медленно отъезжает",
"extend_video_url": "https://cdn.example.com/source-video-1.mp4",
"extend_duration": 5,
"resolution": "720p",
"generate_audio": True
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
{
"id": "op_uuid-123",
"status": "queued",
"tool": "seedance-2-5-flash",
"cost": 132,
"balance_after": 868,
"created_at": "2026-11-15T12:00:00Z"
}
{
"id": "op_uuid-123",
"status": "completed",
"tool": "seedance-2-5-flash",
"cost": 132,
"created_at": "2026-11-15T12:00:00Z",
"completed_at": "2026-11-15T12:01:40Z",
"result": {
"type": "video",
"urls": ["https://storage.bratuha.ru/results/seedance-2-5-flash/result.mp4"]
},
"error_message": null
}
{
"id": "op_uuid-123",
"status": "failed",
"tool": "seedance-2-5-flash",
"cost": 132,
"created_at": "2026-11-15T12:00:00Z",
"completed_at": "2026-11-15T12:00:52Z",
"result": null,
"error_message": "Не удалось выполнить операцию"
}
После создания операции сохраните id и используйте его для отдельной проверки статуса:
GET /api/v1/operations/{id}id возвращается сразу после POST /api/v1/operations.curl -H "Authorization: Bearer brth_ваш_ключ" \
https://bratuha.ru/api/v1/operations/op_uuid-123
const response = await fetch(
'https://bratuha.ru/api/v1/operations/op_uuid-123',
{
headers: {
Authorization: 'Bearer brth_ваш_ключ',
},
},
)
const data = await response.json()
console.log(data)
После успешного завершения операция возвращает result в таком формате:
{
"type": "video",
"urls": ["https://storage.bratuha.ru/results/seedance-2-5-flash/result.mp4"]
}
type всегда "video";urls - массив ссылок на готовый ролик в формате MP4; обычно один запуск возвращает один ролик, но обрабатывайте результат как массив;edit ролик той же длины, что и исходное видео;extend в urls только новый фрагмент длиной extend_duration, без исходного ролика. Чтобы получить ролик целиком, склейте исходное видео и результат.Итоговая цена = число секунд × ставка за секунду. Секунды округляются вверх до целого.
Без видео на входе платится только длина ролика:
| Режим | Что считается секундами | 480p | 720p |
|---|---|---|---|
text, image, references без video_urls | duration | 10 ₽ | 22 ₽ |
Если на входе есть видео, оплачиваются и секунды входного видео, и секунды готового ролика по ставке 6 ₽ в 480p и 14 ₽ в 720p:
| Режим | Что считается секундами | 480p | 720p |
|---|---|---|---|
references с непустым video_urls | duration + суммарная длина video_urls | 6 ₽ | 14 ₽ |
extend | extend_duration + длина extend_video_url | 6 ₽ | 14 ₽ |
edit | длина edit_video_url дважды (вход и результат той же длины) | 12 ₽ за секунду исходника | 28 ₽ за секунду исходника |
Длину входных видео сервер определяет сам по файлам перед созданием операции. Изображения, аудио, size и generate_audio на цену не влияют.
Примеры расчёта:
text, 6 секунд, 720p: 6 × 22 ₽ = 132 ₽.image, 5 секунд, 480p: 5 × 10 ₽ = 50 ₽.references, ролик 8 секунд, видео-референсы суммарно 10 секунд, 480p: (8 + 10) × 6 ₽ = 108 ₽.edit, исходное видео 7,3 секунды, 720p: 8 × 28 ₽ = 224 ₽.extend, исходник 10 секунд, extend_duration = 5, 720p: (10 + 5) × 14 ₽ = 210 ₽.POST /api/v1/operations не идемпотентен: каждый повторный запрос создаёт новую операцию.queued, затем отдельно проверяете статус по id.http/https ссылки без localhost, loopback и private IP. Ссылка должна открываться без авторизации - иначе операция завершится со статусом failed..jpg, .jpeg, .png, .webp: каждая сторона от 300 до 6000 пикселей, соотношение сторон от 1:2,5 до 2,5:1..mp4 и .mov, для аудио - .wav и .mp3.720p. Для 1080p используйте seedance-2-5.image нельзя передать референсы: только первый и конечный кадр.edit исходное видео - от 4 до 30 секунд: если оно короче или длиннее, операция не создаётся. Результат - ролик той же длины и с теми же пропорциями.failed. Чаще всего это касается сгенерированной музыки: уберите её из prompt или передайте generate_audio: false.string[] (url) |
| Нет |
Только для режима edit: изображения для правки, например новая одежда, предмет или фон. До 10 изображений, каждое до 30 МБ. На цену не влияют. |
edit_audio_urls | string[] (url) | Нет | Только для режима edit: аудио, например голос или музыка. До 5 файлов, каждый до 15 МБ, суммарно до 30 секунд. На цену не влияют. |
extend_video_url | string (url) | Да | URL видео, которое нужно продлить. Обязателен только в режиме extend. MP4 или MOV, от 2 до 30 секунд, до 200 МБ. Секунды исходника входят в цену: для продления хватит его последних секунд. |
extend_duration | number | Да | Только для режима extend: сколько секунд добавить, от 4 до 30. Используется для расчёта цены. |
size | enum | Да | Соотношение сторон для режимов text и references. Варианты: adaptive (нейросеть подберёт сама по заданию и референсам), 16:9, 9:16, 1:1, 4:3, 3:4, 21:9. В режимах image, edit и extend не используется - пропорции берутся из файла. |
resolution | enum | Да | Разрешение ролика: 480p или 720p. Влияет на цену. |
duration | number | Да | Длительность ролика в секундах, от 4 до 30. Для режимов text, image и references. Используется для расчёта цены. |
generate_audio | boolean | Нет | Добавляет к ролику речь, шумы и музыку под сцену. При false ролик будет без звука, в режиме edit тоже. На цену не влияет. |