Переносит человека из вашего видео или фото в новое место: фон меняется по заданию и образцу, а свет на человеке подстраивается под новую сцену. Цена зависит от разрешения: 720p — 15 ₽/сек., 1080p — 45 ₽/сек., фото — 15 или 45 ₽.
Общая документация Public API · API-ключ можно создать в настройках аккаунта
Beeble SwitchX переносит человека из вашего видео или фото в другое место. Человек, его лицо и движения остаются как в исходнике, а фон меняется по текстовому заданию и, если нужно, по картинке-образцу. Свет на человеке пересчитывается под новую сцену, поэтому он не выглядит вклеенным.
Типичные задачи:
Вызов создаёт асинхронную операцию: сначала приходит id, затем вы проверяете статус, пока не будет готов результат.
POST /api/v1/operationsAuthorization: Bearer brth_...id и стартовый статус queued.Режим выбирается параметром generation_type:
generation_type | Что на входе | Что получится |
|---|---|---|
video | Видео от 1 до 8 секунд | То же видео, где человек оказался в новом месте |
image | Одно фото | То же фото, где человек оказался в новом месте |
Если generation_type не передать, будет video. Для video передайте ссылку в video, для image - в image. Поле другого режима не нужно.
{
"tool": "beeble-switchx",
"input": {
"generation_type": "video",
"...": "..."
}
}
tool - slug нейросети, всегда "beeble-switchx".input - параметры запуска. Все поля передаются прямо внутри этого объекта, вложенных объектов нет.| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
generation_type | enum | Да | Режим: video - видео, image - фото. По умолчанию video. |
prompt | string | Да | Куда перенести человека и какой нужен свет: место, время суток, погода, настроение. От 3 до 2000 символов, можно по-русски. |
video | string (url) | Для video | Ссылка на исходное видео от 1 до 8 секунд. Только внешние http/https URL с расширением .mp4, .mov или .webm, файл до 100 МБ. По длине ролика считается цена. |
image | string (url) | Для image | Ссылка на исходное фото. Расширения .jpg, .jpeg, .png, .webp. |
reference_image | string (url) | Нет | Картинка-образец нового места: нейросеть берёт с неё обстановку, цвета и свет. Расширения .jpg, .jpeg, .png, .webp. Можно не передавать, тогда место строится только по prompt. |
alpha_mode | enum | Да | Что заменить: auto - фон вокруг человека, сам человек остаётся, fill - весь кадр, ничего не вырезается, меняются стиль и свет всей сцены. По умолчанию auto. |
resolution | enum | Да | Разрешение результата: 720p или 1080p. По умолчанию 720p. От него зависит цена. |
generation_type: video)Человек из 5-секундного ролика идёт по ночной улице Токио. 720p, стоимость - 75 ₽.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "beeble-switchx",
"input": {
"generation_type": "video",
"prompt": "Ночная улица Токио после дождя, неоновые вывески, отражения в мокром асфальте",
"video": "https://cdn.example.com/source-video-1.mp4",
"alpha_mode": "auto",
"resolution": "720p"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'beeble-switchx',
input: {
generation_type: 'video',
prompt: 'Ночная улица Токио после дождя, неоновые вывески, отражения в мокром асфальте',
video: 'https://cdn.example.com/source-video-1.mp4',
alpha_mode: 'auto',
resolution: '720p',
},
}),
})
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': 'beeble-switchx',
'input': {
'generation_type': 'video',
'prompt': 'Ночная улица Токио после дождя, неоновые вывески, отражения в мокром асфальте',
'video': 'https://cdn.example.com/source-video-1.mp4',
'alpha_mode': 'auto',
'resolution': '720p',
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
8-секундный ролик, новое место берётся с картинки-образца. 1080p, стоимость - 360 ₽.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "beeble-switchx",
"input": {
"generation_type": "video",
"prompt": "Пляж на закате, тёплый мягкий свет со стороны моря",
"video": "https://cdn.example.com/source-video-2.mp4",
"reference_image": "https://cdn.example.com/reference-image-1.jpg",
"alpha_mode": "auto",
"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: 'beeble-switchx',
input: {
generation_type: 'video',
prompt: 'Пляж на закате, тёплый мягкий свет со стороны моря',
video: 'https://cdn.example.com/source-video-2.mp4',
reference_image: 'https://cdn.example.com/reference-image-1.jpg',
alpha_mode: 'auto',
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': 'beeble-switchx',
'input': {
'generation_type': 'video',
'prompt': 'Пляж на закате, тёплый мягкий свет со стороны моря',
'video': 'https://cdn.example.com/source-video-2.mp4',
'reference_image': 'https://cdn.example.com/reference-image-1.jpg',
'alpha_mode': 'auto',
'resolution': '1080p',
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
generation_type: image)Человек с фото оказывается в светлом офисе с панорамными окнами. 720p, стоимость - 15 ₽.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "beeble-switchx",
"input": {
"generation_type": "image",
"prompt": "Светлый офис с панорамными окнами, дневной свет, город за окном",
"image": "https://cdn.example.com/source-image-1.jpg",
"alpha_mode": "auto",
"resolution": "720p"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'beeble-switchx',
input: {
generation_type: 'image',
prompt: 'Светлый офис с панорамными окнами, дневной свет, город за окном',
image: 'https://cdn.example.com/source-image-1.jpg',
alpha_mode: 'auto',
resolution: '720p',
},
}),
})
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': 'beeble-switchx',
'input': {
'generation_type': 'image',
'prompt': 'Светлый офис с панорамными окнами, дневной свет, город за окном',
'image': 'https://cdn.example.com/source-image-1.jpg',
'alpha_mode': 'auto',
'resolution': '720p',
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
{
"id": "op_uuid-123",
"status": "queued",
"tool": "beeble-switchx",
"cost": 75,
"balance_after": 925,
"created_at": "2026-11-03T10:15:02Z"
}
cost - сколько списано за операцию, в рублях.balance_after - баланс после списания.{
"id": "op_uuid-123",
"status": "completed",
"tool": "beeble-switchx",
"cost": 75,
"created_at": "2026-11-03T10:15:02Z",
"completed_at": "2026-11-03T10:18:40Z",
"result": {
"type": "video",
"urls": [
"https://storage.bratuha.ru/results/beeble-switchx/video-1.mp4"
]
},
"error_message": null
}
{
"id": "op_uuid-123",
"status": "failed",
"tool": "beeble-switchx",
"cost": 75,
"created_at": "2026-11-03T10:15:02Z",
"completed_at": "2026-11-03T10:16:10Z",
"result": null,
"error_message": "Ваш запрос не прошел модерацию."
}
Деньги за операцию со статусом 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, 10000))
}
}
Статус операции:
queued - операция создана и ждёт запуска;processing - файл обрабатывается;completed - готово, ссылка лежит в result;failed - не получилось, причина в error_message.Фото обычно готово за минуту-две, видео - за несколько минут, 1080p дольше 720p. Опрашивать статус раз в 10 секунд достаточно, чаще раза в секунду нельзя - придёт 429.
Результат - один файл: видео MP4 для video и изображение для image.
{
"type": "video",
"urls": [
"https://storage.bratuha.ru/results/beeble-switchx/video-1.mp4"
]
}
type - "video" или "image", по режиму.urls - массив из одной ссылки на готовый файл.Пропорции кадра повторяют исходник. Ролик с частотой выше 30 кадров в секунду приводится к 30 кадрам в секунду.
Видео оплачивается за каждую секунду исходного ролика, фото - за штуку. Ставка зависит от resolution:
resolution | Видео, за секунду | Видео 5 с | Видео 8 с | Фото |
|---|---|---|---|---|
720p | 15 ₽ | 75 ₽ | 120 ₽ | 15 ₽ |
1080p | 45 ₽ | 225 ₽ | 360 ₽ | 45 ₽ |
Длительность сервер сам определяет по файлу и округляет вверх до целой секунды: ролик 4,2 секунды считается как 5 секунд. Минимум - 1 секунда, максимум - 8 секунд.
Задание, образец и alpha_mode на цену не влияют. Точная сумма приходит в поле cost ответа на создание операции и сразу списывается с баланса. Ставки могут меняться - перед массовыми запусками сверяйтесь с cost или передавайте max_price.
POST /api/v1/operations не идемпотентен: каждый запрос создаёт новую операцию и списывает деньги. Чтобы безопасно повторять запрос при обрыве связи, передайте UUID в заголовке Idempotency-Key: повтор в течение 24 часов вернёт исходную операцию без нового списания.max_price в теле запроса, если хотите, чтобы сервер отклонил запуск дороже согласованной суммы ещё до списания.queued, результат нужно забирать запросом статуса по id.http/https URL, которые открываются без авторизации. Видео - .mp4, .mov или .webm до 100 МБ, фото - .jpg, .jpeg, .png, .webp.400, операция не создастся и деньги не спишутся. Длинный ролик обрежьте заранее.auto нейросеть сама находит человека; если в кадре нет людей, используйте fill.prompt описывайте место и свет, а не человека: внешность и движения берутся из исходника и не меняются.