Перейти к основному контенту

Переведите слышимую речь в видео на выбранный язык и синхронизируйте губы с HeyGen Video Translate. Укажите video_url, выберите один из 178 языковых вариантов и режим precision или speed. Необходимо разрешение каждого, кто в результате будет произносить переведённую речь.

От $0.048/с

Рабочая область

Отправить запрос

Быстрый старт

Примеры используют публичные параметры выбранного эндпоинта. Замените API-ключ и примеры медиафайлов, затем отправьте запрос со своего сервера.

SDK и интеграции
POSThttps://api.spicyapi.ai/api/v1/jobs/createTask

Аутентификация API

Храните API-ключ в серверной переменной окружения SPICY_API_KEY. Используйте Bearer-аутентификацию и Content-Type: application/json для JSON-запросов.

Authorization: Bearer $SPICY_API_KEY
Пример результатаИспользовать пример
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "heygen/video-translate/video-translate",
  "input": {
    "generation_mode": "precision",
    "target_language": "English",
    "video_url": "https://example.com/reference.mp4"
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Пример построен по входной схеме этой модели — той же, по которой API проверяет каждый запрос.

Входные параметры

Поместите эти поля в объект input тела запроса. Имена и типы соответствуют API. Не предполагайте значение по умолчанию, если оно не задано.

video_urlstringОбязательноВлияет на цену

Обязательное видео с речью длительностью до 120 секунд. Страница модели принимает MP4 и WebM. Убедитесь, что участники согласились на видео, где они произносят перевод голосом, похожим на их собственный; слишком длинные ролики отклоняются без оплаты.

По умолчанию
Не задано
Ограничения
minLength:1
format:"uri"
contentMediaType:["video/mp4","video/webm","video/quicktime"]
generation_modestringНеобязательноВлияет на цену

Выберите precision, используемый по умолчанию, для приоритета качества синхронизации губ. Режим speed рассчитан на более быстрый результат при тарифе вдвое ниже Precision; время выполнения не гарантируется.

По умолчанию
"precision"
Допустимые значения
"precision""speed"
target_languagestringНеобязательно

По умолчанию английский. Выберите один из 178 вариантов базовых языков и региональных диалектов, включая два варианта английского акцента. Изменение языка перевода не влияет на посекундный тариф.

По умолчанию
"English"
Допустимые значения
"English""Spanish""French""Hindi""Italian""German""Polish""Portuguese""Chinese""Japanese""Dutch""Turkish""Korean""Danish""Arabic""Romanian""Mandarin""Filipino""Swedish""Indonesian""Ukrainian""Greek""Czech""Bulgarian""Malay""Slovak""Croatian""Tamil""Finnish""Russian""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)""Basque""Bengali (India)""Bosnian (Bosnia and Herzegovina)""Bulgarian (Bulgaria)""Burmese (Myanmar)""Catalan""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)""Galician""Georgian (Georgia)""German (Austria)""German (Germany)""German (Switzerland)""Greek (Greece)""Gujarati (India)""Hebrew (Israel)""Hindi (India)""Hungarian (Hungary)""Icelandic (Iceland)""Indonesian (Indonesia)""Irish (Ireland)""Italian (Italy)""Japanese (Japan)""Javanese (Latin, Indonesia)""Kannada (India)""Kazakh (Kazakhstan)""Khmer (Cambodia)""Korean (Korea)""Lao (Laos)""Latvian (Latvia)""Lithuanian (Lithuania)""Macedonian (North Macedonia)""Malay (Malaysia)""Malayalam (India)""Maltese (Malta)""Marathi (India)""Mongolian (Mongolia)""Nepali (Nepal)""Norwegian Bokmål (Norway)""Pashto (Afghanistan)""Persian (Iran)""Polish (Poland)""Portuguese (Brazil)""Portuguese (Portugal)""Romanian (Romania)""Russian (Russia)""Serbian (Latin, Serbia)""Sinhala (Sri Lanka)""Slovak (Slovakia)""Slovenian (Slovenia)""Somali (Somalia)""Spanish (Argentina)""Spanish (Bolivia)""Spanish (Chile)""Spanish (Colombia)""Spanish (Costa Rica)""Spanish (Cuba)""Spanish (Dominican Republic)""Spanish (Ecuador)""Spanish (El Salvador)""Spanish (Equatorial Guinea)""Spanish (Guatemala)""Spanish (Honduras)""Spanish (Mexico)""Spanish (Nicaragua)""Spanish (Panama)""Spanish (Paraguay)""Spanish (Peru)""Spanish (Puerto Rico)""Spanish (Spain)""Spanish (United States)""Spanish (Uruguay)""Spanish (Venezuela)""Sundanese (Indonesia)""Swahili (Kenya)""Swahili (Tanzania)""Swedish (Sweden)""Tamil (India)""Tamil (Malaysia)""Tamil (Singapore)""Tamil (Sri Lanka)""Telugu (India)""Thai (Thailand)""Turkish (Türkiye)""Ukrainian (Ukraine)""Urdu (India)""Urdu (Pakistan)""Uzbek (Latin, Uzbekistan)""Vietnamese (Vietnam)""Welsh (United Kingdom)""Zulu (South Africa)""English - Your Accent""English - American Accent"

Отследить задачу

HTTP 202 означает принятие задачи, а не завершение генерации. Сохраните полученный taskId и проверяйте эту задачу. Не создавайте новую, пока ждёте результат.

Ответ при приёме задачи
HTTP/1.1 202 Accepted
Location: /api/v1/jobs/recordInfo?taskId=job_01k3m8x9q2z4v7n5p6r8s0t1w3

{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_create",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "state": "queued",
    "estimatedCost": "0.750000"
  }
}

В ответе о приёме есть оценка стоимости — приложение сможет показать ту же сумму в истории задач и в расчётах.

Получить задачу
curl --get "https://api.spicyapi.ai/api/v1/jobs/recordInfo" \
  --data-urlencode "taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Начните с интервала около 2 секунд и постепенно увеличивайте его. Прекратите опрос при конечном состоянии. После сбоя соединения используйте исходный taskId. Повторно создавать задачу можно только с исходным ключом идемпотентности и исходным телом запроса.

Или пусть вызов придёт сам
import { verifyWebhook } from "@spicyapi/sdk";

// express.raw keeps the bytes we signed; express.json never matches.
app.post("/hooks/spicy", express.raw({ type: "application/json" }), (req, res) => {
  const { payload } = verifyWebhook({
    rawBody: req.body,
    timestamp: req.header("X-Webhook-Timestamp"),
    signature: req.header("X-Webhook-Signature"),
    payloadVersion: Number(req.header("X-Webhook-Payload-Version")),
    secret: process.env.SPICY_WEBHOOK_SECRET,
  });
  res.status(200).end();
  void handleFinishedTask(payload);
});

Передайте callBackUrl при создании задачи — готовая запись придёт к вам POST-запросом, и никакого опроса не понадобится. В каждой доставке есть X-Webhook-Timestamp, X-Webhook-Signature и X-Webhook-Payload-Version. Подпись — это HMAC-SHA256 в base64 от taskId.timestamp.sha256(body), поэтому проверять её нужно по исходным байтам: если разобрать JSON и сериализовать заново, байты изменятся и проверка не пройдёт. Неудачные доставки повторяются, так что один и тот же taskId может прийти дважды — сделайте обработчик идемпотентным. Сначала ответьте 2xx, работу выполняйте после: медленный обработчик считается неудачной доставкой.

Прочитать результат

Обрабатывайте output только при state, равном succeeded. При ошибке проверьте errorCode, errorMessage и request_id. Стоимость и состояния в примерах не являются фактическим счётом.

Пример ответа после завершения
{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_record",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "model": "heygen/video-translate/video-translate",
    "state": "succeeded",
    "output": {
      "assets": [
        {
          "key": "tasks/2026/08/28/job_01k3m8x9q2z4v7n5p6r8s0t1w3/3f7a1c9e5b2d48f0a6c1e3d5b7f9a1c3.mp4",
          "mime": "video/mp4",
          "url": "https://example.r2.cloudflarestorage.com/results/job_01k3m8x9q2z4v7n5p6r8s0t1w3/result.mp4?X-Amz-Signature=SIGNATURE_FROM_RESPONSE",
          "expiresAt": "2026-08-28T12:20:08.000Z"
        }
      ]
    },
    "cost": "0.750000",
    "settled": true,
    "createdAt": "2026-08-28T12:00:00Z",
    "completedAt": "2026-08-28T12:00:30Z"
  }
}

Доступные файлы можно открыть или скачать по assets[].url без заголовка API Authorization. Подписанная ссылка действует до expiresAt. Чтобы обновить её, повторно запросите задачу в течение срока хранения файла. У ожидающих или недоступных файлов URL отсутствует. Не передавайте подписанные ссылки посторонним.

SDK и интеграции

Используйте SpicyAPI в приложении, терминале, ИИ-ассистенте или визуальном процессе. Выберите руководство по настройке.

Использование в ComfyUI

Установите узлы SpicyAPI через ComfyUI Manager или командой ниже и найдите на холсте HeyGen Video Translate · Translate Video with Lip Sync. У узла те же параметры, что и на этой странице, а цена показывается до запуска.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi