Heygen Translate 2 API

Heygen Translate 2 API

Heygen Translate 2 переводит речь в видео на другой язык: распознаёт, что говорят люди в кадре, переводит, озвучивает перевод голосами, похожими на исходные, и подстраивает движения губ под новый текст. Язык исходной речи определяется сам.

Подходит для перевода интервью, подкастов, обучающих курсов, обзоров и рекламы. В отличие от heygen-video-translate, здесь можно выбрать быстрый или точный режим, перевести только звук без правки губ, указать число говорящих и отправить видео длиннее 2 минут.

Сценарии:

• Быстрый перевод (speed) - дешевле и быстрее, подходит для большинства роликов.
• Точный перевод (precision) - вдвое дороже, губы подстраиваются аккуратнее. Стоит выбирать для крупных планов и роликов, где лицо в кадре главное.
• Перевод только звука - картинка остаётся исходной, меняется лишь голосовая дорожка. Подходит, когда говорящего не видно или важна неизменная картинка.

Каждый вызов создаёт асинхронную операцию. Сохраните id из ответа и проверяйте статус, пока не придёт готовое видео.

Создание операции

• Endpoint: POST /api/v1/operations
• Авторизация: Authorization: Bearer brth_...
• Выполнение асинхронное: запрос сразу возвращает id операции и стартовый статус queued.

Режим задаётся параметром generation_type: speed или precision. Перевод только звука включается параметром translate_audio_only и работает в обоих режимах.

Тело запроса

{
  "tool": "heygen-translate-2",
  "input": {
    "video_url": "https://cdn.example.com/interview.mp4",
    "generation_type": "speed",
    "output_language": "English"
  }
}

• tool - slug нейросети, всегда "heygen-translate-2".
• input - параметры запуска. Поля передаются прямо внутри этого объекта, без дополнительной вложенности.

Параметры

Ссылка на видео должна открываться без авторизации по http/https. Расширение в ссылке должно совпадать с одним из допустимых форматов, иначе API вернёт validation_error.

Языки перевода

Всего 178 значений. Основные языки:

Региональные варианты (143) - язык с указанием страны или письменности, значение передаётся целиком, со скобками:

Afrikaans (South Africa), Albanian (Albania), Amharic (Ethiopia), Arabic (Algeria), Arabic (Bahrain), Arabic (Egypt), Arabic (Iraq), Arabic (Jordan), Arabic (Kuwait), Arabic (Lebanon), Arabic (Libya), Arabic (Morocco), Arabic (Oman), Arabic (Qatar), Arabic (Saudi Arabia), Arabic (Syria), Arabic (Tunisia), Arabic (United Arab Emirates), Arabic (Yemen), Armenian (Armenia), Azerbaijani (Latin, Azerbaijan), Bangla (Bangladesh), Bengali (India), Bosnian (Bosnia and Herzegovina), Bulgarian (Bulgaria), Burmese (Myanmar), Chinese (Cantonese, Traditional), Chinese (Jilu Mandarin, Simplified), Chinese (Mandarin, Simplified), Chinese (Northeastern Mandarin, Simplified), Chinese (Southwestern Mandarin, Simplified), Chinese (Taiwanese Mandarin, Traditional), Chinese (Wu, Simplified), Chinese (Zhongyuan Mandarin Henan, Simplified), Chinese (Zhongyuan Mandarin Shaanxi, Simplified), Croatian (Croatia), Czech (Czechia), Danish (Denmark), Dutch (Belgium), Dutch (Netherlands), English (Australia), English (Canada), English (Hong Kong SAR), English (India), English (Ireland), English (Kenya), English (New Zealand), English (Nigeria), English (Philippines), English (Singapore), English (South Africa), English (Tanzania), English (UK), English (United States), Estonian (Estonia), Filipino (Philippines), Finnish (Finland), French (Belgium), French (Canada), French (France), French (Switzerland), Georgian (Georgia), German (Austria), German (Germany), , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , .

Значение должно совпадать со списком буква в букву, включая пробелы, дефис и скобки. Любое другое значение API отклонит с ошибкой validation_error.

Примеры запросов

Быстрый перевод на английский

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "heygen-translate-2",
  "input": {
    "video_url": "https://cdn.example.com/interview.mp4",
    "generation_type": "speed",
    "output_language": "English"
  }
}'

JavaScript / TypeScript

const response = await fetch('https://bratuha.ru/api/v1/operations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer brth_ваш_ключ',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tool: 'heygen-translate-2',
    input: {
      video_url: 'https://cdn.example.com/interview.mp4',
      generation_type: 'speed',
      output_language: 'English',
    },
  }),
})

const data = await response.json()

Python

import requests

response = requests.post(
    'https://bratuha.ru/api/v1/operations',
    headers={
        'Authorization': 'Bearer brth_ваш_ключ',
        'Content-Type': 'application/json',
    },
    json={
        'tool': 'heygen-translate-2',
        'input': {
            'video_url': 'https://cdn.example.com/interview.mp4',
            'generation_type': 'speed',
            'output_language': 'English',
        },
    },
    timeout=30,
)

print(response.status_code)
print(response.json())

Точный перевод с подстройкой губ

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "heygen-translate-2",
  "input": {
    "video_url": "https://cdn.example.com/presenter-closeup.mov",
    "generation_type": "precision",
    "output_language": "German",
    "enable_dynamic_duration": true
  }
}'

JavaScript / TypeScript

const response = await fetch('https://bratuha.ru/api/v1/operations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer brth_ваш_ключ',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tool: 'heygen-translate-2',
    input: {
      video_url: 'https://cdn.example.com/presenter-closeup.mov',
      generation_type: 'precision',
      output_language: 'German',
      enable_dynamic_duration: true,
    },
  }),
})

const data = await response.json()

Python

import requests

response = requests.post(
    'https://bratuha.ru/api/v1/operations',
    headers={
        'Authorization': 'Bearer brth_ваш_ключ',
        'Content-Type': 'application/json',
    },
    json={
        'tool': 'heygen-translate-2',
        'input': {
            'video_url': 'https://cdn.example.com/presenter-closeup.mov',
            'generation_type': 'precision',
            'output_language': 'German',
            'enable_dynamic_duration': True,
        },
    },
    timeout=30,
)

print(response.status_code)
print(response.json())

Перевод только звука, двое говорящих

Картинка остаётся исходной, перевод укладывается в тайминг оригинала:

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "heygen-translate-2",
  "input": {
    "video_url": "https://cdn.example.com/podcast.webm",
    "generation_type": "speed",
    "output_language": "Spanish",
    "translate_audio_only": true,
    "speaker_num": 2,
    "enable_dynamic_duration": false
  }
}'

JavaScript / TypeScript

const response = await fetch('https://bratuha.ru/api/v1/operations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer brth_ваш_ключ',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tool: 'heygen-translate-2',
    input: {
      video_url: 'https://cdn.example.com/podcast.webm',
      generation_type: 'speed',
      output_language: 'Spanish',
      translate_audio_only: true,
      speaker_num: 2,
      enable_dynamic_duration: false,
    },
  }),
})

const data = await response.json()

Python

import requests

response = requests.post(
    'https://bratuha.ru/api/v1/operations',
    headers={
        'Authorization': 'Bearer brth_ваш_ключ',
        'Content-Type': 'application/json',
    },
    json={
        'tool': 'heygen-translate-2',
        'input': {
            'video_url': 'https://cdn.example.com/podcast.webm',
            'generation_type': 'speed',
            'output_language': 'Spanish',
            'translate_audio_only': True,
            'speaker_num': 2,
            'enable_dynamic_duration': False,
        },
    },
    timeout=30,
)

print(response.status_code)
print(response.json())

Примеры ответов

Ответ после создания

Пример для видео длиной 5,04 секунды в режиме speed: длительность округляется вверх до 6 секунд, 6 × 8 ₽ = 48 ₽.

{
  "id": "op_uuid-123",
  "status": "queued",
  "tool": "heygen-translate-2",
  "cost": 48,
  "balance_after": 452,
  "created_at": "2026-09-30T21:32:18.09495+00:00"
}

Ответ после завершения

{
  "id": "op_uuid-123",
  "status": "completed",
  "tool": "heygen-translate-2",
  "cost": 48,
  "created_at": "2026-09-30T21:32:18.09495+00:00",
  "completed_at": "2026-09-30T21:34:19.019932+00:00",
  "result": {
    "type": "video",
    "urls": [
      "https://storage.bratuha.ru/results/heygen-translate-2/video-1.mp4"
    ]
  },
  "error_message": null
}

Ответ при ошибке

{
  "id": "op_uuid-123",
  "status": "failed",
  "tool": "heygen-translate-2",
  "cost": 48,
  "created_at": "2026-09-30T21:32:18.09495+00:00",
  "completed_at": "2026-09-30T21:33:02.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, 15000))
  }
}

Ролик на 5 секунд в режиме speed был готов за 2 минуты, ролики на 10-30 секунд обычно переводятся за 2-3 минуты, в режиме precision - немного дольше. Опрашивать одну операцию можно не чаще раза в секунду, иначе API ответит 429, но для этой нейросети достаточно проверять статус раз в 10-15 секунд.

Формат результата

После завершения в поле result приходит видео:

{
  "type": "video",
  "urls": [
    "https://storage.bratuha.ru/results/heygen-translate-2/video-1.mp4"
  ]
}

• type - всегда "video".
• urls - массив ссылок на готовые видео. Для этой нейросети в нём одна ссылка на MP4.

Что внутри файла:

• Разрешение и ориентация кадра - как у исходного ролика. Из вертикального видео 832×1088 получилось видео 832×1088, 25 кадров в секунду.
• Звуковая дорожка заменена переводом, голоса похожи на голоса говорящих в исходнике.
• В файл вшита отдельная дорожка субтитров на языке перевода. Плееры показывают её, если включить субтитры, в картинку текст не впечатан.
• При enable_dynamic_duration: true длина готового ролика может немного отличаться от исходной: из видео на 5,04 секунды получилось 5,2 секунды, из 10 секунд - 10,9. Цена считается только по исходному видео.

Если операция завершилась с ошибкой, result будет null, а причина придёт в error_message.

Ценообразование

Цена считается за каждую секунду исходного видео и зависит от режима:

Как считается итог:

1. Сервер сам определяет длительность видео по ссылке video_url. Передавать длительность в запросе не нужно.
2. Длительность округляется вверх до целой секунды: 5,04 секунды считаются как 6.
3. Округлённая длительность умножается на цену секунды.

Язык, translate_audio_only, speaker_num и enable_dynamic_duration на цену не влияют. Итоговая сумма приходит в поле cost сразу в ответе на создание операции и списывается с баланса в этот момент. Если операция завершилась ошибкой, деньги возвращаются на баланс, а cost в ответе остаётся суммой запуска. Перед отправкой длинного видео проверьте его длительность: минута в precision стоит 960 ₽.

Ограничения и практические заметки

• POST /api/v1/operations не идемпотентен: каждый повторный запрос создаёт новую операцию и списывает деньги заново.
• Операция выполняется асинхронно: сначала вы получаете queued, результат забираете по id.
• Видео передаётся только внешней http/https ссылкой, доступной без авторизации, размером до 128 МБ, в формате mp4, mov или webm. Локальные адреса и приватные сети не принимаются.
• Видео должно длиться не меньше 1 секунды. Если по ссылке не удалось прочитать длительность (например, файл повреждён), API сразу вернёт validation_error, операция не создастся и деньги не спишутся.
• speaker_num принимает только целые числа от 1 до 20, дробное значение API отклонит.
• В видео должна быть внятная человеческая речь. Ролики без речи, где звучат только музыка или звуковые эффекты, завершаются ошибкой, в том числе «Ваш запрос не прошел модерацию».
• Лучший результат - когда лицо говорящего хорошо видно и звук чистый, без громкой музыки. Для роликов с несколькими говорящими укажите speaker_num.
• Если перевод нужен на несколько языков, создайте отдельную операцию на каждый язык.