Общая документация Public API · API-ключ можно создать в настройках аккаунта
Seedance 2.5 создаёт видео по тексту, по изображениям и по готовым референсам, а ещё правит и продлевает готовые ролики. Модель подходит для рекламных роликов, коротких сцен, анимации фотографий и монтажных переходов между двумя кадрами.
Режимы вызова, описанные ниже:
text - видео только по текстовому описанию;image - видео на основе одного или нескольких исходных изображений;frames - плавный переход между первым и последним кадром;references - видео по смешанным референсам: изображения, видео и аудио одновременно;edit - правка готового видео по заданию: заменить одежду, предмет, фон или стиль, сохранив движение и длину исходного ролика;extend - продление готового ролика вперёд или назад: модель дописывает новый фрагмент, который продолжает исходное видео.При 480p по умолчанию включён черновик (draft_mode): ролик в 480p по обычной цене, который потом можно сделать в 1080p на сайте - тот же сюжет, движение и звук.
Каждый вызов создаёт асинхронную операцию. Сразу после запроса API возвращает id и стартовый статус, а готовый ролик нужно получить отдельной проверкой статуса.
POST /api/v1/operationsAuthorization: Bearer brth_...id и стартовый статус.Режим вызова выбирается параметром seedance_2_5_generation_type:
text - видео из текста;image - видео из изображений;frames - переход между первым и последним кадром;references - видео по референсам;edit - редактирование видео;extend - продление видео.{
"tool": "seedance-2-5",
"input": {
"seedance_2_5_generation_type": "text",
"...": "..."
}
}
tool - slug нейросети, всегда "seedance-2-5".input - параметры конкретного запуска.input зависит от выбранного seedance_2_5_generation_type.input, без дополнительного вложенного объекта input.input.| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
seedance_2_5_generation_type | enum | Да | Режим генерации. Варианты: text (видео из текста), image (видео из изображений), frames (переход между первым и последним кадром), references (видео по референсам), edit (редактирование видео), extend (продление видео). Определяет, какие остальные поля нужно передавать. |
mode | enum | Нет | normal (по умолчанию) или cheap — дешёвый режим, только text и frames: 480p — 9 ₽/сек., 720p — 19 ₽/сек., 1080p — 46 ₽/сек. В cheap нет водяного знака, черновика и MOV; выполнение может занять больше времени. |
prompt | string | Да | Текстовое задание: сцена, действие, стиль, движение камеры и атмосфера. Для обычной генерации описывайте сцену без команд редактирования или продления, в режиме edit - что изменить в исходном видео. От 2 до 20000 символов. |
image_urls | string[] (url) | Да | Массив внешних URL изображений. Обязателен и учитывается только в режиме image. От 1 до 30 изображений, каждое до 30 МБ. Разрешены только http/https ссылки. |
first_frame_url | string (url) | Да | URL первого кадра. Обязателен только в режиме frames. До 30 МБ. |
last_frame_url | string (url) | Да | URL конечного кадра. Обязателен только в режиме frames. До 30 МБ. |
reference_image_urls | string[] (url) | Нет | Массив референсных изображений для режима references. До 30 изображений, каждое до 30 МБ. |
video_urls | string[] (url) | Нет | Массив видео-референсов для режима references. До 10 видео, каждое до 200 МБ, длительность одного файла от 2 до 30 секунд, суммарно до 30 секунд, разрешение 480p, 720p или 1080p. Наличие непустого меняет ставку - подробности в разделе «Ценообразование». |
В режиме references нужно передать хотя бы один референс - reference_image_urls, video_urls или audio_urls. Если не передать ни одного, операция не создаётся.
В режимах edit и extend параметры size, duration и watermark не используются: соотношение сторон берётся из исходного видео. Длина результата в edit равна длине исходного видео, в extend её задаёт extend_duration.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "seedance-2-5",
"input": {
"seedance_2_5_generation_type": "text",
"prompt": "Кинематографичный вид ночного мегаполиса с высоты: неоновые вывески, лёгкий туман, плавное движение камеры вперёд, отражения огней в мокром асфальте",
"size": "16:9",
"resolution": "720p",
"duration": 6,
"generate_audio": true,
"watermark": false,
"output_format": "mp4"
}
}'
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',
input: {
seedance_2_5_generation_type: 'text',
prompt:
'Кинематографичный вид ночного мегаполиса с высоты: неоновые вывески, лёгкий туман, плавное движение камеры вперёд, отражения огней в мокром асфальте',
size: '16:9',
resolution: '720p',
duration: 6,
generate_audio: true,
watermark: false,
output_format: 'mp4',
},
}),
})
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",
"input": {
"seedance_2_5_generation_type": "text",
"prompt": "Кинематографичный вид ночного мегаполиса с высоты: неоновые вывески, лёгкий туман, плавное движение камеры вперёд, отражения огней в мокром асфальте",
"size": "16:9",
"resolution": "720p",
"duration": 6,
"generate_audio": True,
"watermark": False,
"output_format": "mp4",
},
},
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",
"input": {
"seedance_2_5_generation_type": "image",
"prompt": "Оживи фотографии: лёгкое покачивание волос от ветра, естественное дыхание и моргание, камера почти статична",
"image_urls": [
"https://cdn.example.com/source-image-1.jpg",
"https://cdn.example.com/source-image-2.jpg"
],
"size": "9:16",
"resolution": "480p",
"duration": 5,
"generate_audio": false,
"output_format": "mp4"
}
}'
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',
input: {
seedance_2_5_generation_type: 'image',
prompt:
'Оживи фотографии: лёгкое покачивание волос от ветра, естественное дыхание и моргание, камера почти статична',
image_urls: [
'https://cdn.example.com/source-image-1.jpg',
'https://cdn.example.com/source-image-2.jpg',
],
size: '9:16',
resolution: '480p',
duration: 5,
generate_audio: false,
output_format: 'mp4',
},
}),
})
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",
"input": {
"seedance_2_5_generation_type": "image",
"prompt": "Оживи фотографии: лёгкое покачивание волос от ветра, естественное дыхание и моргание, камера почти статична",
"image_urls": [
"https://cdn.example.com/source-image-1.jpg",
"https://cdn.example.com/source-image-2.jpg",
],
"size": "9:16",
"resolution": "480p",
"duration": 5,
"generate_audio": False,
"output_format": "mp4",
},
},
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",
"input": {
"seedance_2_5_generation_type": "frames",
"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",
"size": "adaptive",
"resolution": "720p",
"duration": 4,
"output_format": "mov"
}
}'
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',
input: {
seedance_2_5_generation_type: 'frames',
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',
size: 'adaptive',
resolution: '720p',
duration: 4,
output_format: 'mov',
},
}),
})
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",
"input": {
"seedance_2_5_generation_type": "frames",
"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",
"size": "adaptive",
"resolution": "720p",
"duration": 4,
"output_format": "mov",
},
},
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",
"input": {
"seedance_2_5_generation_type": "references",
"prompt": "Собери сцену по референсам: поза и ракурс героя как в референс-видео, одежда и фон как на референсных изображениях",
"reference_image_urls": [
"https://cdn.example.com/source-image-3.jpg",
"https://cdn.example.com/source-image-4.jpg"
],
"video_urls": [
"https://cdn.example.com/source-video-1.mp4",
"https://cdn.example.com/source-video-2.mov"
],
"size": "16:9",
"resolution": "480p",
"duration": 6,
"generate_audio": false,
"output_format": "mp4"
}
}'
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',
input: {
seedance_2_5_generation_type: 'references',
prompt:
'Собери сцену по референсам: поза и ракурс героя как в референс-видео, одежда и фон как на референсных изображениях',
reference_image_urls: [
'https://cdn.example.com/source-image-3.jpg',
'https://cdn.example.com/source-image-4.jpg',
],
video_urls: [
'https://cdn.example.com/source-video-1.mp4',
'https://cdn.example.com/source-video-2.mov',
],
size: '16:9',
resolution: '480p',
duration: 6,
generate_audio: false,
output_format: 'mp4',
},
}),
})
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",
"input": {
"seedance_2_5_generation_type": "references",
"prompt": "Собери сцену по референсам: поза и ракурс героя как в референс-видео, одежда и фон как на референсных изображениях",
"reference_image_urls": [
"https://cdn.example.com/source-image-3.jpg",
"https://cdn.example.com/source-image-4.jpg",
],
"video_urls": [
"https://cdn.example.com/source-video-1.mp4",
"https://cdn.example.com/source-video-2.mov",
],
"size": "16:9",
"resolution": "480p",
"duration": 6,
"generate_audio": False,
"output_format": "mp4",
},
},
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",
"input": {
"seedance_2_5_generation_type": "references",
"prompt": "Создай видео с персонажем, который поёт и двигается в такт голосу из референсного аудио, атмосфера сцены - как в задании",
"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,
"output_format": "mp4"
}
}'
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',
input: {
seedance_2_5_generation_type: 'references',
prompt:
'Создай видео с персонажем, который поёт и двигается в такт голосу из референсного аудио, атмосфера сцены - как в задании',
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,
output_format: 'mp4',
},
}),
})
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",
"input": {
"seedance_2_5_generation_type": "references",
"prompt": "Создай видео с персонажем, который поёт и двигается в такт голосу из референсного аудио, атмосфера сцены - как в задании",
"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,
"output_format": "mp4",
},
},
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",
"input": {
"seedance_2_5_generation_type": "extend",
"prompt": "Гончар отставляет готовый горшок в сторону, вытирает руки о фартук и встаёт из-за круга. Камера медленно отъезжает",
"extend_video_url": "https://cdn.example.com/source-video-1.mp4",
"extend_direction": "forward",
"extend_duration": 5,
"resolution": "720p",
"generate_audio": true,
"output_format": "mp4"
}
}'
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',
input: {
seedance_2_5_generation_type: 'extend',
prompt:
'Гончар отставляет готовый горшок в сторону, вытирает руки о фартук и встаёт из-за круга. Камера медленно отъезжает',
extend_video_url: 'https://cdn.example.com/source-video-1.mp4',
extend_direction: 'forward',
extend_duration: 5,
resolution: '720p',
generate_audio: true,
output_format: 'mp4',
},
}),
})
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",
"input": {
"seedance_2_5_generation_type": "extend",
"prompt": "Гончар отставляет готовый горшок в сторону, вытирает руки о фартук и встаёт из-за круга. Камера медленно отъезжает",
"extend_video_url": "https://cdn.example.com/source-video-1.mp4",
"extend_direction": "forward",
"extend_duration": 5,
"resolution": "720p",
"generate_audio": True,
"output_format": "mp4",
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
Исходный ролик передаётся в edit_video_url, изображения и аудио для правки - в edit_image_urls и edit_audio_urls. В prompt на них ссылаются как @video1, @image1, @image2, @audio1 и так далее - по порядку в массивах. size, duration и watermark не передаются: результат будет той же длины и с теми же пропорциями, что исходное видео.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "seedance-2-5",
"input": {
"seedance_2_5_generation_type": "edit",
"prompt": "Замени куртку героя на куртку с @image1, а кепку на кепку с @image2. Движение, фон и свет оставь как в @video1. Герой говорит голосом из @audio1, на фоне тихо звучит музыка из @audio2",
"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"
],
"edit_audio_urls": [
"https://cdn.example.com/source-audio-1.mp3",
"https://cdn.example.com/source-audio-2.wav"
],
"resolution": "720p",
"generate_audio": true,
"output_format": "mp4"
}
}'
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',
input: {
seedance_2_5_generation_type: 'edit',
prompt:
'Замени куртку героя на куртку с @image1, а кепку на кепку с @image2. Движение, фон и свет оставь как в @video1. Герой говорит голосом из @audio1, на фоне тихо звучит музыка из @audio2',
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',
],
edit_audio_urls: [
'https://cdn.example.com/source-audio-1.mp3',
'https://cdn.example.com/source-audio-2.wav',
],
resolution: '720p',
generate_audio: true,
output_format: 'mp4',
},
}),
})
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",
"input": {
"seedance_2_5_generation_type": "edit",
"prompt": "Замени куртку героя на куртку с @image1, а кепку на кепку с @image2. Движение, фон и свет оставь как в @video1. Герой говорит голосом из @audio1, на фоне тихо звучит музыка из @audio2",
"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",
],
"edit_audio_urls": [
"https://cdn.example.com/source-audio-1.mp3",
"https://cdn.example.com/source-audio-2.wav",
],
"resolution": "720p",
"generate_audio": True,
"output_format": "mp4",
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
При resolution = "480p" черновик включён по умолчанию, в примере draft_mode передан явно. Так можно быстро и недорого проверить сюжет, а удачный вариант потом сделать в 1080p. Пример - видео из текста, но черновик работает так же в режимах image, frames, references и edit.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "seedance-2-5",
"input": {
"seedance_2_5_generation_type": "text",
"prompt": "Бариста ставит на стойку чашку капучино с рисунком в виде листа, пар поднимается над чашкой, камера медленно приближается",
"size": "9:16",
"resolution": "480p",
"draft_mode": "on",
"duration": 5,
"generate_audio": true,
"output_format": "mp4"
}
}'
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',
input: {
seedance_2_5_generation_type: 'text',
prompt:
'Бариста ставит на стойку чашку капучино с рисунком в виде листа, пар поднимается над чашкой, камера медленно приближается',
size: '9:16',
resolution: '480p',
draft_mode: 'on',
duration: 5,
generate_audio: true,
output_format: 'mp4',
},
}),
})
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",
"input": {
"seedance_2_5_generation_type": "text",
"prompt": "Бариста ставит на стойку чашку капучино с рисунком в виде листа, пар поднимается над чашкой, камера медленно приближается",
"size": "9:16",
"resolution": "480p",
"draft_mode": "on",
"duration": 5,
"generate_audio": True,
"output_format": "mp4",
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
{
"id": "op_uuid-123",
"status": "queued",
"tool": "seedance-2-5",
"cost": 168,
"balance_after": 832,
"created_at": "2026-08-08T12:00:00Z"
}
{
"id": "op_uuid-123",
"status": "completed",
"tool": "seedance-2-5",
"cost": 168,
"created_at": "2026-08-08T12:00:00Z",
"completed_at": "2026-08-08T12:04:12Z",
"result": {
"type": "video",
"urls": ["https://storage.bratuha.ru/results/seedance-2-5/result.mp4"]
},
"error_message": null
}
{
"id": "op_uuid-123",
"status": "failed",
"tool": "seedance-2-5",
"cost": 168,
"created_at": "2026-08-08T12:00:00Z",
"completed_at": "2026-08-08T12:01:03Z",
"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/result.mp4"]
}
Что важно знать:
type всегда "video";urls - массив ссылок на готовый файл в формате mp4 или mov, в зависимости от output_format;edit ролик той же длины, что и исходное видео;extend в urls только новый фрагмент длиной extend_duration, без исходного ролика. Чтобы получить ролик целиком, склейте исходное видео и результат: при forward результат идёт после исходного видео, при backward - перед ним.draft_mode = "on") в urls ролик в 480p. Ролик в 1080p из черновика - это отдельная операция, её создаёт кнопка «Сделать в 1080p» на сайте.Итоговая цена = длительность ролика в секундах (duration, округляется вверх до целого, от 4 до 30) × ставка за секунду.
Ставка зависит от разрешения (resolution) и от того, используются ли видео-референсы (video_urls, доступны только в режиме references):
| Разрешение | Видео-референсы | Ставка за секунду |
|---|---|---|
480p | Нет | 14 ₽ |
720p | Нет | 28 ₽ |
1080p | Нет | 55 ₽ |
480p | Да | 8 ₽ |
720p | Да | 16 ₽ |
1080p | Да | 30 ₽ |
Если в режиме references загружены видео-референсы, дополнительно оплачивается их суммарная длительность - её сервер определяет сам по метаданным файлов:
resolution = 480p - дополнительно 8 ₽ за каждую секунду видео-референсов;resolution = 720p - дополнительно 16 ₽ за каждую секунду видео-референсов;resolution = 1080p - дополнительно 30 ₽ за каждую секунду видео-референсов.В режиме edit длина результата равна длине исходного видео, поэтому цена считается по ней: итоговая цена = длительность edit_video_url в секундах × ставка. Ставка - 16 ₽ за секунду в 480p, 32 ₽ в 720p, 60 ₽ в 1080p. Длительность исходного видео сервер определяет сам по файлу и округляет вверх до целого. Изображения и аудио (edit_image_urls, edit_audio_urls) на цену не влияют.
В режиме extend оплачиваются и секунды исходного видео, и добавленные секунды по той же ставке: 8 ₽ за секунду в 480p, 16 ₽ в 720p, 30 ₽ в 1080p. Итоговая цена = (длительность extend_video_url + extend_duration) × ставка; добавленные секунды округляются вверх до целого, длительность исходного видео сервер определяет сам по метаданным файла.
Черновик (draft_mode = "on") стоит столько же, сколько обычный ролик в 480p в том же режиме. Ролик в 1080p из черновика стоит 55 ₽ за секунду: за duration, а у черновика в режиме edit - за длительность исходного видео. Секунды видео-референсов второй раз не оплачиваются.
Изображения и аудио-референсы (reference_image_urls, audio_urls) на цену не влияют. Параметры generate_audio, watermark, output_format и draft_mode тоже не влияют на цену запуска.
Примеры расчёта:
720p, без видео-референсов (режимы text, image, frames или references без video_urls): 6 × 28 ₽ = 168 ₽.480p, без видео-референсов: 5 × 14 ₽ = 70 ₽.1080p, без видео-референсов: 5 × 55 ₽ = 275 ₽.references, ролик на 6 секунд, 480p, суммарная длительность видео-референсов 10 секунд: 6 × 8 ₽ + 10 × 8 ₽ = 48 ₽ + 80 ₽ = 128 ₽.references, ролик на 6 секунд, 720p, суммарная длительность видео-референсов 10 секунд: 6 × 16 ₽ + 10 × 16 ₽ = 96 ₽ + 160 ₽ = 256 ₽.references, ролик на 6 секунд, 1080p, суммарная длительность видео-референсов 10 секунд: 6 × 30 ₽ + 10 × 30 ₽ = 180 ₽ + 300 ₽ = 480 ₽.edit, исходное видео 8 секунд, 720p: 8 × 32 ₽ = 256 ₽.extend, исходное видео 10 секунд, extend_duration = 5, 720p: (10 + 5) × 16 ₽ = 240 ₽.text, 5 секунд, 480p, draft_mode = "on": 5 × 14 ₽ = 70 ₽. Ролик в 1080p из этого черновика - ещё 5 × 55 ₽ = 275 ₽.POST /api/v1/operations не идемпотентен: каждый повторный запрос создаёт новую операцию.queued, затем отдельно проверяете статус по id.http/https ссылки без localhost, loopback и private IP.image_urls, first_frame_url, last_frame_url, reference_image_urls, edit_image_urls) используйте .jpg, .jpeg, .png, .webp, .bmp, .tiff, .tif, .gif. Форматы HEIC/HEIF, которые поддерживаются при загрузке файлов через интерфейс сайта, в Public API по внешнему URL не принимаются.video_urls, edit_video_url, extend_video_url) используйте .mp4 и .mov.audio_urls, edit_audio_urls) используйте .wav и .mp3.failed, поэтому проверяйте файлы заранее.frames доступно только size = "adaptive" - остальные значения соотношения сторон сервер отклонит.references нужно передать хотя бы один референс: reference_image_urls, video_urls или audio_urls.duration можно передать нецелым числом, но для расчёта цены секунды всегда округляются вверх до целого.extend исходное видео (extend_video_url) - MP4 или MOV от 2 до 30 секунд; результат - только новый фрагмент без исходного ролика, в выбранном resolution и с пропорциями исходного видео.extend описывайте в prompt, что происходит дальше (или раньше при ); ссылка указывает на исходное видео.video_urlsaudio_urls | string[] (url) | Нет | Массив аудио-референсов для режима references. До 10 файлов, каждый до 15 МБ, длительность одного файла от 2 до 30 секунд, суммарно до 30 секунд. |
edit_video_url | string (url) | Да | URL видео, которое нужно изменить. Обязателен только в режиме edit. MP4 или MOV, длительность от 4 до 30 секунд, до 200 МБ. Результат будет той же длины. Длительность сервер определяет сам по файлу, она входит в цену. |
edit_image_urls | string[] (url) | Нет | Только для режима edit: изображения-референсы для правки, например новая одежда, предмет или фон. До 30 изображений, каждое до 30 МБ. На цену не влияют. |
edit_audio_urls | string[] (url) | Нет | Только для режима edit: аудио-референсы, например голос или музыка. До 10 файлов, каждый до 15 МБ, длительность одного файла от 2 до 30 секунд. На цену не влияют. |
extend_video_url | string (url) | Да | URL видео, которое нужно продлить. Обязателен только в режиме extend. MP4 или MOV, длительность от 2 до 30 секунд, до 200 МБ. Длительность сервер определяет сам по метаданным файла, она входит в цену. |
extend_direction | enum | Нет | Только для режима extend. Варианты: forward (что было дальше, после конца ролика) и backward (что было до его начала). По умолчанию forward. На цену не влияет. |
extend_duration | number | Да | Только для режима extend: сколько секунд добавить, от 4 до 30. В результате будет фрагмент именно этой длины. Используется для расчёта цены. |
size | enum | Да | Соотношение сторон. Варианты: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive (подстраивается под загруженный материал). В режиме frames доступно только adaptive - остальные значения сервер отклонит. |
resolution | enum | Да | Разрешение ролика. Варианты: 480p, 720p, 1080p. Чем выше разрешение, тем детальнее результат и выше цена. Влияет на цену. |
draft_mode | enum | Нет | Черновик: on (включён) или off (выключен). Работает только при resolution = "480p" во всех режимах, кроме extend, и при 480p включён, если параметр не передать. Черновик - ролик в 480p по обычной цене 480p; из него в течение 7 дней можно сделать тот же ролик в 1080p на сайте - подробности в разделе «Ограничения и практические заметки». Чтобы получить обычный ролик в 480p, передайте off. При других разрешениях и в extend параметр не учитывается. |
duration | number | Да | Длительность ролика в секундах, от 4 до 30. Используется для расчёта цены. |
generate_audio | boolean | Нет | Добавляет звук к ролику, если модель может согласовать его со сценой. На цену не влияет. |
watermark | boolean | Нет | Добавляет отметку о том, что видео создано с помощью ИИ. На цену не влияет. |
output_format | enum | Да | Формат готового файла. Варианты: mp4, mov. |
backward@video1edit исходное видео (edit_video_url) - MP4 или MOV от 4 до 30 секунд: если оно короче или длиннее, операция не создаётся. Результат - ролик той же длины и с теми же пропорциями.edit описывайте в prompt, что изменить, и ссылайтесь на файлы по порядку: @video1 - исходное видео, @image1, @image2 - изображения из edit_image_urls, @audio1, @audio2 - аудио из edit_audio_urls.draft_mode) работает только при resolution = "480p" и не работает в режиме extend. При 480p он включён по умолчанию, поэтому запросы с 480p без draft_mode (как в сценариях 2, 4 и 5) тоже создают черновик - по той же цене. Нужен обычный ролик - передайте "draft_mode": "off".1080p из черновика через Public API пока не создаётся. Откройте результат на bratuha.ru под тем же аккаунтом (запуски по API видны в ленте результатов) и нажмите «Сделать в 1080p». Кнопка работает 7 дней с момента создания черновика; получится тот же сюжет, движение и звук, мелкие детали могут немного отличаться.