Заменяет людей в вашем видео на персонажей с фото — до 4 человек за раз, сохраняя сцену, движения, ракурс и звук. Цена зависит от разрешения: 480p — 22 ₽/сек., 540p — 25 ₽/сек., 768p — 30 ₽/сек., 1080p — 60 ₽/сек.
Общая документация Public API · API-ключ можно создать в настройках аккаунта
Openjutsu Character Swap берёт готовое видео до 15 секунд и меняет людей в нём на ваших персонажей с фото. Всё остальное остаётся как было снято: фон, движения, ракурс, монтаж внутри кадра и звук. Так делают ролики с собой или с маскотом в чужой сцене, пробуют разных актёров в одном дубле, меняют героя рекламного ролика без пересъёмки.
За один запуск можно заменить до 4 человек. Если персонаж один, нейросеть сама выберет самого заметного человека в кадре. Если персонажей несколько, подпишите, кого именно заменить: без подписей нейросеть сама решает, кому какой персонаж достанется. Платите за секунды исходного видео, ставка зависит от разрешения. Вызов создаёт асинхронную операцию: сначала приходит id, затем вы проверяете статус, пока не будет готово видео.
POST /api/v1/operationsAuthorization: Bearer brth_...id и стартовый статус queued.Режим один, но вызывать его удобно тремя способами:
| Сценарий | Что передать в characters | Кого заменит нейросеть |
|---|---|---|
| Один персонаж | 1 объект с image | Самого заметного человека в кадре |
| Несколько персонажей без подписей | 2-4 объекта с image без role | Кого выберет сама нейросеть. В нашей пробе - похожих по виду людей, не обязательно первых слева |
| Несколько персонажей с подписями | 1-4 объекта с image и role | Только тех, кого вы описали в role, остальные люди остаются как были |
{
"tool": "openjutsu-character-swap",
"input": {
"video": "https://cdn.example.com/source-video-1.mp4",
"characters": [
{ "image": "https://cdn.example.com/character-1.jpg" }
],
"resolution": "768p"
}
}
tool - slug нейросети, всегда "openjutsu-character-swap".input - параметры запуска: ссылка на видео, массив персонажей и разрешение.| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
video | string (url) | Да | Ссылка на исходное видео до 15 секунд с расширением .mp4, .mov или .webm. Лучше всего работает один план без склеек, где человек виден уже в первом кадре. По длине ролика считается цена, звук исходника сохраняется. |
characters | object[] | Да | От 1 до 4 персонажей, по одному на каждого человека, которого нужно заменить. Каждый объект - image и, если нужно, role. |
characters[].image | string (url) | Да | Ссылка на фото персонажа: .jpg, .jpeg, .png или .webp. Подойдёт портрет, фото в полный рост или рисованный герой. |
characters[].role | string | Нет | Кого заменить этим персонажем, коротко и по приметам: «женщина в чёрном слева», «мужчина в очках за рулём». До 200 символов. Если персонажей несколько, подпишите каждого: у неподписанного выбор человека остаётся за нейросетью. |
resolution | enum | Да | Разрешение результата: 480p, 540p, 768p или 1080p. Если не передать, будет 768p. От него зависит ставка за секунду. |
Девушка в ролике идёт по улице, её меняем на персонажа с фото. Видео 6 секунд, 480p, стоимость - 132 ₽.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "openjutsu-character-swap",
"input": {
"video": "https://cdn.example.com/source-video-1.mp4",
"characters": [
{ "image": "https://cdn.example.com/character-1.jpg" }
],
"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-character-swap',
input: {
video: 'https://cdn.example.com/source-video-1.mp4',
characters: [{ image: 'https://cdn.example.com/character-1.jpg' }],
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-character-swap',
'input': {
'video': 'https://cdn.example.com/source-video-1.mp4',
'characters': [{'image': 'https://cdn.example.com/character-1.jpg'}],
'resolution': '480p',
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
В 10-секундном ролике за столиком кафе сидят двое. Женщину слева меняем на персонажа с первого фото, мужчину справа - на персонажа со второго. 1080p, стоимость - 600 ₽.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "openjutsu-character-swap",
"input": {
"video": "https://cdn.example.com/source-video-2.mp4",
"characters": [
{
"image": "https://cdn.example.com/character-1.jpg",
"role": "женщина в красном платье слева"
},
{
"image": "https://cdn.example.com/character-2.jpg",
"role": "мужчина в сером пиджаке справа"
}
],
"resolution": "1080p"
}
}'
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-character-swap',
input: {
video: 'https://cdn.example.com/source-video-2.mp4',
characters: [
{
image: 'https://cdn.example.com/character-1.jpg',
role: 'женщина в красном платье слева',
},
{
image: 'https://cdn.example.com/character-2.jpg',
role: 'мужчина в сером пиджаке справа',
},
],
resolution: '1080p',
},
}),
})
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-character-swap',
'input': {
'video': 'https://cdn.example.com/source-video-2.mp4',
'characters': [
{
'image': 'https://cdn.example.com/character-1.jpg',
'role': 'женщина в красном платье слева',
},
{
'image': 'https://cdn.example.com/character-2.jpg',
'role': 'мужчина в сером пиджаке справа',
},
],
'resolution': '1080p',
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
{
"id": "op_uuid-123",
"status": "queued",
"tool": "openjutsu-character-swap",
"cost": 132,
"balance_after": 868,
"created_at": "2026-11-03T10:15:02Z"
}
cost - сколько списано за операцию, в рублях.balance_after - баланс после списания.{
"id": "op_uuid-123",
"status": "completed",
"tool": "openjutsu-character-swap",
"cost": 132,
"created_at": "2026-11-03T10:15:02Z",
"completed_at": "2026-11-03T10:19:40Z",
"result": {
"type": "video",
"urls": [
"https://storage.bratuha.ru/results/openjutsu-character-swap/video-1.mp4"
]
},
"error_message": null
}
{
"id": "op_uuid-123",
"status": "failed",
"tool": "openjutsu-character-swap",
"cost": 132,
"created_at": "2026-11-03T10:15:02Z",
"completed_at": "2026-11-03T10:17:12Z",
"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-5 секунд в 480p-768p были готовы за 1-2 минуты, в 1080p - за 4 минуты. Длинные ролики обрабатываются дольше. Опрашивать статус раз в 10-15 секунд достаточно, чаще раза в секунду нельзя - придёт 429.
Результат - одно видео MP4:
{
"type": "video",
"urls": [
"https://storage.bratuha.ru/results/openjutsu-character-swap/video-1.mp4"
]
}
type - всегда "video".urls - массив из одной ссылки на готовый файл.Пропорции кадра повторяют исходник, а короткая сторона соответствует resolution: вертикальный ролик 720×1280 вернулся в 480p как 480×864, в 1080p - как 1056×1920, горизонтальный 1280×720 в 768p - как 1376×768. Звук исходника сохраняется. Результат бывает примерно на полсекунды короче исходника: из ролика на 5 секунд в наших запусках пришло 4,46 секунды, из ролика на 4 секунды - 3,75 секунды. Частота кадров - 24 в секунду.
Цена - за каждую секунду исходного видео, ставка зависит только от 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 ₽ |
Длительность сервер сам определяет по файлу и округляет вверх до целой секунды: ролик 6,2 секунды считается как 7 секунд. Максимум - 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, операция не создастся и деньги не спишутся. Длинный ролик обрежьте заранее.role. Без подписей в нашей пробе с шестью людьми в кадре нейросеть выбрала не крайних слева, а похожих: седого персонажа поставила на место седой женщины. Фото, которому в видео никто не подошёл, нейросеть пропускает.role пишите по приметам, которые видно в кадре: одежда, волосы, место в кадре, действие. Русский язык нейросеть понимает. Имена и роли из сюжета она не знает.