Меняет в вашем видео причёску, одежду, предмет или весь фон по описанию или картинке-образцу, сохраняя движение, ракурс и исходный звук. Цена зависит от разрешения: 480p — 22 ₽/сек., 540p — 25 ₽/сек., 768p — 30 ₽/сек., 1080p — 60 ₽/сек., картинка-образец — ещё 15 ₽.
Общая документация Public API · API-ключ можно создать в настройках аккаунта
Openjutsu Object Swap берёт готовое видео до 15 секунд и меняет в нём что-то одно, а всё остальное оставляет как было: движение, ракурс, монтаж и звук исходника. Два сценария:
Что получится, описывается текстом. Можно добавить картинку-образец: одежду, причёску, товар или место, которые нужно перенести в видео. Платите за секунды исходного видео, ставка зависит от разрешения. Вызов создаёт асинхронную операцию: сначала приходит id, затем вы проверяете статус, пока не будет готово видео.
POST /api/v1/operationsAuthorization: Bearer brth_...id и стартовый статус queued.Режим выбирается параметром mode:
mode | Что указать | Что получится |
|---|---|---|
change | target_change - что заменить, change_to_object - на что | То же видео, где выбранная вещь заменена |
background | target_background - что оставить, change_to_background - новый фон | Тот же человек или предмет в другом месте |
Если mode не передать, будет change. Поля другого режима передавать не нужно, они не учитываются.
{
"tool": "openjutsu-object-swap",
"input": {
"mode": "change",
"...": "..."
}
}
tool - slug нейросети, всегда "openjutsu-object-swap".input - параметры запуска. Все поля передаются прямо внутри этого объекта, вложенных объектов нет.| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
mode | enum | Да | Режим: change - замена объекта, background - замена фона. По умолчанию change. |
video | string (url) | Да | Ссылка на исходное видео до 15 секунд, одна сцена без склеек. Только внешние http/https URL с расширением .mp4, .mov или .webm. По длине ролика считается цена. |
target_change | string | Да, в change | Что заменить - одно-два английских слова, как это выглядит в видео: yellow raincoat, hair, red car. Несколько вещей - через запятую: hair, top. Только латиница, цифры, пробелы, запятые, дефис и апостроф, от 2 до 200 символов. |
change_to_object | string | Да, в change | На что заменить: короткие ярко-розовые волосы, красный кабриолет. Можно по-русски, от 2 до 2000 символов. |
target_background | string | Да, в background | Что оставить на месте, одно-два английских слова: person, woman with a dog. Те же правила, что у target_change. |
change_to_background | string | Да, в background | Новый фон: ночная улица Токио под дождём, неоновые вывески. Можно по-русски, от 2 до 2000 символов. |
image | string (url) | Нет | Картинка-образец, с которой нужно взять внешний вид: одежда, причёска, товар или место. Расширения .jpg, .jpeg, .png, .webp. Добавляет 15 ₽ к цене. Текстовое описание всё равно обязательно. |
resolution | enum | Да | Разрешение результата: 480p, 540p, 768p или 1080p. По умолчанию 768p. От него зависит ставка за секунду. |
В 5-секундном ролике девушка идёт по улице в жёлтом дождевике, меняем его на чёрное кожаное пальто. 480p, стоимость - 110 ₽.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "openjutsu-object-swap",
"input": {
"mode": "change",
"video": "https://cdn.example.com/source-video-1.mp4",
"target_change": "yellow raincoat",
"change_to_object": "длинное чёрное кожаное пальто с поясом",
"resolution": "480p"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'openjutsu-object-swap',
input: {
mode: 'change',
video: 'https://cdn.example.com/source-video-1.mp4',
target_change: 'yellow raincoat',
change_to_object: 'длинное чёрное кожаное пальто с поясом',
resolution: '480p',
},
}),
})
const data = await response.json()
import requests
response = requests.post(
'https://bratuha.ru/api/v1/operations',
headers={
'Authorization': 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
json={
'tool': 'openjutsu-object-swap',
'input': {
'mode': 'change',
'video': 'https://cdn.example.com/source-video-1.mp4',
'target_change': 'yellow raincoat',
'change_to_object': 'длинное чёрное кожаное пальто с поясом',
'resolution': '480p',
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
Девушка за стойкой кафе держит чашку капучино, меняем её на стакан сока с картинки. Ролик 6 секунд, 480p: 6 × 22 ₽ + 15 ₽ за картинку = 147 ₽.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "openjutsu-object-swap",
"input": {
"mode": "change",
"video": "https://cdn.example.com/source-video-2.mp4",
"image": "https://cdn.example.com/source-image-1.jpg",
"target_change": "cup",
"change_to_object": "стакан апельсинового сока с картинки",
"resolution": "480p"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'openjutsu-object-swap',
input: {
mode: 'change',
video: 'https://cdn.example.com/source-video-2.mp4',
image: 'https://cdn.example.com/source-image-1.jpg',
target_change: 'cup',
change_to_object: 'стакан апельсинового сока с картинки',
resolution: '480p',
},
}),
})
const data = await response.json()
import requests
response = requests.post(
'https://bratuha.ru/api/v1/operations',
headers={
'Authorization': 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
json={
'tool': 'openjutsu-object-swap',
'input': {
'mode': 'change',
'video': 'https://cdn.example.com/source-video-2.mp4',
'image': 'https://cdn.example.com/source-image-1.jpg',
'target_change': 'cup',
'change_to_object': 'стакан апельсинового сока с картинки',
'resolution': '480p',
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
Пожилой рыбак сидит у костра, переносим его на палубу парусной лодки. Ролик 4 секунды, 768p, стоимость - 120 ₽.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "openjutsu-object-swap",
"input": {
"mode": "background",
"video": "https://cdn.example.com/source-video-3.mp4",
"target_background": "man",
"change_to_background": "палуба парусной лодки в открытом море на рассвете",
"resolution": "768p"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'openjutsu-object-swap',
input: {
mode: 'background',
video: 'https://cdn.example.com/source-video-3.mp4',
target_background: 'man',
change_to_background: 'палуба парусной лодки в открытом море на рассвете',
resolution: '768p',
},
}),
})
const data = await response.json()
import requests
response = requests.post(
'https://bratuha.ru/api/v1/operations',
headers={
'Authorization': 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
json={
'tool': 'openjutsu-object-swap',
'input': {
'mode': 'background',
'video': 'https://cdn.example.com/source-video-3.mp4',
'target_background': 'man',
'change_to_background': 'палуба парусной лодки в открытом море на рассвете',
'resolution': '768p',
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
{
"id": "op_uuid-123",
"status": "queued",
"tool": "openjutsu-object-swap",
"cost": 110,
"balance_after": 890,
"created_at": "2026-11-03T13:45:02Z"
}
cost - сколько списано за операцию, в рублях.balance_after - баланс после списания.{
"id": "op_uuid-123",
"status": "completed",
"tool": "openjutsu-object-swap",
"cost": 110,
"created_at": "2026-11-03T13:45:02Z",
"completed_at": "2026-11-03T13:49:10Z",
"result": {
"type": "video",
"urls": [
"https://storage.bratuha.ru/results/openjutsu-object-swap/video-1.mp4"
]
},
"error_message": null
}
{
"id": "op_uuid-123",
"status": "failed",
"tool": "openjutsu-object-swap",
"cost": 110,
"created_at": "2026-11-03T13:45:02Z",
"completed_at": "2026-11-03T13:47:40Z",
"result": null,
"error_message": "Ваш запрос не прошел модерацию. Запрещено: nsfw."
}
Деньги за операцию со статусом failed возвращаются на баланс.
Сохраните id из ответа на создание и запрашивайте статус операции по нему:
GET /api/v1/operations/{id}
curl -H "Authorization: Bearer brth_ваш_ключ" \
https://bratuha.ru/api/v1/operations/op_uuid-123
async function waitForResult(id) {
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))
}
}
Статус операции:
queued - операция создана и ждёт запуска;processing - видео обрабатывается;completed - готово, ссылка лежит в result;failed - не получилось, причина в error_message.В наших запусках ролики по 4-6 секунд в 480p-768p были готовы за 1-2 минуты, в 1080p - примерно за 2,5 минуты. Длинные ролики обрабатываются дольше. Опрашивать статус раз в 10-15 секунд достаточно, чаще раза в секунду нельзя - придёт 429.
В обоих режимах результат - одно видео MP4:
{
"type": "video",
"urls": [
"https://storage.bratuha.ru/results/openjutsu-object-swap/video-1.mp4"
]
}
type - всегда "video".urls - массив из одной ссылки на готовый файл.Пропорции кадра, движение камеры и звук берутся из исходного видео, разрешение - из resolution: вертикальный ролик 720×1280 в 480p вернулся как 480×864, горизонтальный 1280×720 в 768p - как 1376×768. Частота кадров - 24 в секунду. Результат может быть чуть короче исходника: из роликов на 5 секунд в наших запусках приходило около 4,5 секунды.
Цена - за каждую секунду исходного видео, ставка зависит только от resolution:
resolution | За секунду | 5 с | 10 с | 15 с |
|---|---|---|---|---|
480p | 22 ₽ | 110 ₽ | 220 ₽ | 330 ₽ |
540p | 25 ₽ | 125 ₽ | 250 ₽ | 375 ₽ |
768p | 30 ₽ | 150 ₽ | 300 ₽ | 450 ₽ |
1080p | 60 ₽ | 300 ₽ | 600 ₽ | 900 ₽ |
Картинка-образец в image добавляет 15 ₽ к сумме за запуск. Длительность сервер сам определяет по файлу и округляет вверх до целой секунды: ролик 8,1 секунды считается как 9 секунд. Максимум - 15 секунд.
Режим и текст задания на цену не влияют. Точная сумма приходит в поле cost ответа на создание операции и сразу списывается с баланса. Ставки могут меняться - перед массовыми запусками сверяйтесь с cost или передавайте max_price.
POST /api/v1/operations не идемпотентен: каждый запрос создаёт новую операцию и списывает деньги. Чтобы безопасно повторять запрос при обрыве связи, передайте UUID в заголовке Idempotency-Key: повтор в течение 24 часов вернёт исходную операцию без нового списания.max_price в теле запроса, если хотите, чтобы сервер отклонил запуск дороже согласованной суммы ещё до списания. Полезно для 1080p: 15 секунд стоят 900 ₽.queued, результат нужно забирать запросом статуса по id.http/https URL, которые открываются без авторизации. Видео - .mp4, .mov или .webm, картинка - .jpg, .jpeg, .png, .webp.400, операция не создастся и деньги не спишутся.target_change и target_background пишите по-английски, коротко и так, как это выглядит в кадре: yellow raincoat, а не «clothes of the girl on the left». По русскому названию нейросеть вещь в кадре не находит, поэтому сервер такие значения отклоняет с ошибкой 400. Подробности и пожелания - во втором поле, его можно писать по-русски.