Оживляет портрет по голосу: человек на фото говорит вашей записью, с мимикой и движениями головы. Цена: 540p — 2 ₽/сек., 720p — 4 ₽/сек.
Общая документация Public API · API-ключ можно создать в настройках аккаунта
Talking Avatar 2 оживляет портрет голосом: вы передаёте фотографию человека и запись речи, а модель делает видео, в котором человек на фото произносит эту запись - с движением губ, мимикой, морганием и поворотами головы. Длина ролика равна длине аудио. Так делают говорящих ведущих для роликов и соцсетей, видеопоздравления от лица близких, озвученные ответы персонажа, ожившие старые фотографии.
Сценарии:
prompt настроение и манеру речи и выбираете более высокое качество.Каждый вызов создаёт асинхронную операцию. После запуска сохраните id и проверяйте статус, пока видео не будет готово.
POST /api/v1/operationsAuthorization: Bearer brth_...id операции и стартовый статус queued.Отдельного параметра режима нет: задание передаётся необязательным полем prompt, качество - полем resolution.
{
"tool": "talking-avatar-2",
"input": {
"image": "https://cdn.example.com/portrait.jpg",
"audio": "https://cdn.example.com/voice.mp3",
"resolution": "540p"
}
}
tool - slug нейросети, всегда "talking-avatar-2".input - параметры запуска. Поля передаются прямо внутри этого объекта, без дополнительной вложенности.| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
image | string (url) | Да | Ссылка на портрет человека, которого нужно оживить. Одна картинка до 10 МБ. Форматы: jpg, jpeg, png, webp. Лучше всего подходит фото, где лицо хорошо видно и смотрит примерно в камеру. |
audio | string (url) | Да | Ссылка на запись речи одного человека длительностью от 3 до 60 секунд, до 50 МБ. Форматы: mp3, wav, m4a, aac, flac, ogg, opus. Фоновая музыка допустима. От длительности зависят длина видео и цена. |
prompt | string | Нет | Настроение и манера речи, например «спокойно и с улыбкой» или «эмоционально, с жестами головой». До 2000 символов. Можно не передавать. |
resolution | enum | Нет | Качество видео. 540p - 2 ₽ за секунду, 720p - 4 ₽ за секунду. Если поле не передано, используется 540p. |
Ссылки на файлы должны быть внешними http/https URL, доступными без авторизации. Расширение в ссылке должно совпадать с одним из допустимых форматов, иначе API вернёт validation_error.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "talking-avatar-2",
"input": {
"image": "https://cdn.example.com/portrait.jpg",
"audio": "https://cdn.example.com/voice.mp3",
"resolution": "540p"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'talking-avatar-2',
input: {
image: 'https://cdn.example.com/portrait.jpg',
audio: 'https://cdn.example.com/voice.mp3',
resolution: '540p',
},
}),
})
const data = await response.json()
console.log(data.id, data.cost)
import requests
response = requests.post(
'https://bratuha.ru/api/v1/operations',
headers={
'Authorization': 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
json={
'tool': 'talking-avatar-2',
'input': {
'image': 'https://cdn.example.com/portrait.jpg',
'audio': 'https://cdn.example.com/voice.mp3',
'resolution': '540p',
},
},
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": "talking-avatar-2",
"input": {
"image": "https://cdn.example.com/presenter.png",
"audio": "https://cdn.example.com/speech.wav",
"prompt": "Уверенно и дружелюбно, иногда кивает, взгляд в камеру",
"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: 'talking-avatar-2',
input: {
image: 'https://cdn.example.com/presenter.png',
audio: 'https://cdn.example.com/speech.wav',
prompt: 'Уверенно и дружелюбно, иногда кивает, взгляд в камеру',
resolution: '720p',
},
}),
})
const data = await response.json()
console.log(data.id, data.cost)
import requests
response = requests.post(
'https://bratuha.ru/api/v1/operations',
headers={
'Authorization': 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
json={
'tool': 'talking-avatar-2',
'input': {
'image': 'https://cdn.example.com/presenter.png',
'audio': 'https://cdn.example.com/speech.wav',
'prompt': 'Уверенно и дружелюбно, иногда кивает, взгляд в камеру',
'resolution': '720p',
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
Пример для аудио длиной 8,5 секунды в 540p: длительность округляется вверх до 9 секунд, 9 × 2 ₽ = 18 ₽.
{
"id": "op_uuid-123",
"status": "queued",
"tool": "talking-avatar-2",
"cost": 18,
"balance_after": 482,
"created_at": "2026-11-22T10:00:00.000000+00:00"
}
{
"id": "op_uuid-123",
"status": "completed",
"tool": "talking-avatar-2",
"cost": 18,
"created_at": "2026-11-22T10:00:00.000000+00:00",
"completed_at": "2026-11-22T10:04:20.000000+00:00",
"result": {
"type": "video",
"urls": [
"https://storage.bratuha.ru/results/talking-avatar-2/avatar-1.mp4"
]
},
"error_message": null
}
{
"id": "op_uuid-123",
"status": "failed",
"tool": "talking-avatar-2",
"cost": 18,
"created_at": "2026-11-22T10:00:00.000000+00:00",
"completed_at": "2026-11-22T10:03:10.000000+00:00",
"result": null,
"error_message": "Произошла ошибка, нейросеть временно недоступна. Попробуйте повторить запрос позже."
}
Сохраните id из ответа на создание и запрашивайте операцию, пока status не станет completed или failed:
GET /api/v1/operations/{id}
curl -H "Authorization: Bearer brth_ваш_ключ" \
https://bratuha.ru/api/v1/operations/op_uuid-123
async function waitForOperation(id: string) {
while (true) {
const res = await fetch(`https://bratuha.ru/api/v1/operations/${id}`, {
headers: { Authorization: 'Bearer brth_ваш_ключ' },
})
const op = await res.json()
if (op.status === 'completed' || op.status === 'failed') return op
await new Promise((resolve) => setTimeout(resolve, 10000))
}
}
Генерация небыстрая: ролик на 8-9 секунд в 540p готов примерно за 4-5 минут, в 720p - примерно втрое дольше, около 10 минут. Опрашивать раз в 10-15 секунд вполне достаточно. Чаще раза в секунду одну операцию опрашивать нельзя, иначе API ответит 429.
После завершения в поле result приходит видео:
{
"type": "video",
"urls": [
"https://storage.bratuha.ru/results/talking-avatar-2/avatar-1.mp4"
]
}
type - всегда "video".urls - массив ссылок на готовые видео. Для этой нейросети в нём одна ссылка на MP4.Видео идёт со звуком из вашего аудио, его длина равна длине записи. Пропорции кадра берутся с фотографии: из вертикального портрета получится вертикальное видео. Например, из вертикального фото в 540p получился ролик 480×832, из горизонтального в 720p - 1312×704.
Если операция завершилась с ошибкой, result будет null, а причина придёт в error_message.
Цена считается за каждую секунду аудио и зависит от качества:
resolution | Цена за секунду |
|---|---|
540p | 2 ₽ |
720p | 4 ₽ |
Как считается итог:
audio и определяет его длительность. Передавать длительность в запросе не нужно.Примеры:
| Длина аудио | 540p | 720p |
|---|---|---|
| 3 секунды (минимум) | 6 ₽ | 12 ₽ |
| 8,5 секунды | 18 ₽ | 36 ₽ |
| 30 секунд | 60 ₽ | 120 ₽ |
| 60 секунд (максимум) | 120 ₽ | 240 ₽ |
Итоговая сумма приходит в поле cost сразу в ответе на создание операции и списывается с баланса в этот момент. Если операция завершилась ошибкой, деньги возвращаются на баланс, а cost в ответе остаётся суммой запуска.
POST /api/v1/operations не идемпотентен: каждый повторный запрос создаёт новую операцию и списывает деньги заново.queued, результат забираете по id.http/https URL. Для image - jpg, jpeg, png, webp, для audio - mp3, wav, m4a, aac, flac, ogg, opus. Локальные адреса и приватные сети не принимаются.validation_error, операция не создастся и деньги не спишутся. Длинный текст разбейте на части по минуте и склейте ролики.540p: он вдвое дешевле и втрое быстрее. 720p стоит включать для финальной версии.prompt управляет подачей, а не словами: произносится только то, что есть в аудио.