Введение
Передайте video_url для видео с лицом длиной 1–300 секунд и audio_url для новой речи. Итоговый MP4 сохраняет размеры и частоту кадров исходника, а речь перекодируется в моно AAC. Короткая запись обрезает ролик, длинная продлевает концовку обратным воспроизведением кадров.
| Характеристика | Значение |
|---|---|
| Ввод | Видео Аудио |
| Вывод | Видео |
| Разработчик модели | sync. · lipsync-3, также называется sync-3 |
| Принимаемая пара | Видео с лицом через |
| Диапазон исходника | 1–300 с |
| Получаемый файл | MP4; исходные разрешение и частота кадров; звук моно AAC |
| Поведение временной шкалы | Длина по аудио, с обрезкой или обратным продлением кадров |
| Основа расчёта | Секунды входного видео с округлением вверх |
| Наблюдаемая обработка | Примерно 76 с и 173 с в двух коротких запусках |
| Исключённые входы и настройки | Статичные изображения, встроенный синтез речи, |
Ключевые возможности и особенности
Сохраните выбранный дубль в рабочем процессе
Исходный ролик задаёт изображение лица, а новая запись — слова. lipsync-3 возвращает MP4 с обновлённой синхронизацией: исправленная реплика ведущего или разрешённый перевод урока становятся парой конкретных файлов вместо текстового описания.
Согласуйте концовку с длиной речи
Речь на 6,48 секунды продлила наш исходник на 5,00 секунды до 6,48 секунды за счёт обратного воспроизведения кадров от конца. Если такое движение мешает восприятию, приблизьте длину аудио к длине плана. Перед монтажом просмотрите хвост ролика.
Сохраните размеры кадра и проверьте микс
Оба измеренных ролика сохранили исходные разрешение и частоту кадров: 1280×720 при 24 кадрах/с и 1358×680 при 25 кадрах/с. Итоговый звук — моно AAC, поэтому отдельно от размеров изображения проверьте финальное сведение.
Проверьте сложные движения лица
В документации sync. сказано, что sync-3 учитывает контекст сцены и автоматически обрабатывает перекрытия лица. Проверьте характерный поворот головы или движение руки на своём материале. Наши два запуска фиксируют длительность и время обработки, но не дают балльного сравнения этих визуальных ситуаций.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
video_url | Да | Обязательный URL видео с лицом длиной 1–300 секунд. Для оплаты длительность округляется вверх до целой секунды. Не менее 1 символов |
audio_url | Да | Обязательный URL новой речи; в тестах использовались WAV и MP3. Не менее 1 символов |
Стоимость
$0.162 / секунда
Оплата за секунды входного видео с округлением вверх до целого при длительности от 1 до 300 секунд. Длина аудио не меняет стоимость. Ролики вне диапазона отклоняются до списания, неудачные генерации не оплачиваются.
Сценарии использования
Локализуйте запись урока
Соедините lesson.mp4 с преподавателем, давшим согласие, и отдельно записанный перевод lesson.wav. Вы получите MP4, в котором движения губ следуют этой речи. Перевод и запись нужно подготовить до вызова синхронизации.
Исправьте реплику в анонсе продукта
Отправьте исходный дубль ведущего и WAV с исправленным названием продукта и фразой. В возвращённом видео движения губ будут соответствовать новому тексту: просмотрите реплику, прежде чем заменить ею фрагмент монтажа.
Подготовьте рекламу для разных регионов
Используйте один ролик с представителем бренда и отдельные утверждённые записи для каждого рынка. Каждая пара видео и аудио даёт свой синхронизированный MP4; оплата каждого запроса зависит от длины исходного ролика.
Переозвучьте фрагмент интервью
Добавьте к разрешённому фрагменту интервью новую речевую дорожку MP3. Если она длиннее исходника, внимательно изучите последние кадры MP4: для покрытия аудио изображение продлевается обратным воспроизведением кадров от конца.
Руководство по промптам и практические советы
Выберите и обрежьте видео с лицом
Найдите дубль с хорошо различимым ртом и измерьте длительность до загрузки. Оставьте 1–300 секунд и удалите материал, за который не требуется платить.
Подготовьте новую запись речи
Запишите нужную реплику в аудиофайл; в наших тестах использовались WAV и MP3. Подгоните длину к будущему монтажу, если хотите избежать обрезки или обратного продления видео.
Передайте URL видео и аудио
Отправьте POST /api/v1/jobs/createTask, задав model как sync/lipsync-3/lip-sync и указав
video_urlиaudio_urlвнутри input. Добавьте Bearer API-ключ и возьмите JSON ниже за основу тела запроса.Получите и проверьте MP4
Сохраните возвращённый taskId и проверяйте завершение через /api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID. Скачайте готовый файл и сопоставьте согласные звуки, переходы движений рта и концовку с речевой записью.
Sync Lipsync 3 API для готового видео
Sync Lipsync 3 API запускает lipsync-3 от sync., также называемую sync-3, чтобы согласовать движения губ с новой речью. Передайте video_url и audio_url в sync/lipsync-3/lip-sync. Вы получите MP4 с исходными разрешением и частотой кадров и звуком моно AAC.
В документации модели sync. сообщает об учёте контекста всей сцены и автоматическом распознавании перекрытий. Тесты ниже измеряют свойства медиа, длительность и время обработки.
Отправка запроса синхронизации
Создайте задачу с публичным именем модели и двумя URL медиа внутри input. Сохраните пример как request.json и замените адреса-заглушки:
{
"model": "sync/lipsync-3/lip-sync",
"input": {
"video_url": "https://example.com/presenter.mp4",
"audio_url": "https://example.com/replacement.wav"
}
}
Отправьте этот файл со своим ключом SpicyAPI:
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @request.json
Сохраните data.taskId и запрашивайте GET /api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID с той же авторизацией. Проверяйте состояние задачи до завершения.
Структура ответа
У завершённой задачи видео доступно в data.output.assets. В этом фрагменте опущены другие поля, а идентификаторы и URL служат заглушками; размеры и длительность соответствуют тесту WAV:
{
"code": 200,
"msg": "success",
"data": {
"taskId": "job_example",
"model": "sync/lipsync-3/lip-sync",
"state": "succeeded",
"output": {
"assets": [
{
"url": "https://example.com/dubbed-result.mp4",
"mime": "video/mp4",
"width": 1280,
"height": 720,
"durationSeconds": 4.58
}
]
}
}
}
Параметры и доступные настройки
Этот интерфейс принимает URL исходного видео и URL речевого аудио. Специальные настройки API разработчика передавать не нужно.
| Поле | Обязательно | Что задаёт | Подготовка |
|---|---|---|---|
video_url | Да | Исходное видео с лицом, 1–300 секунд; задаёт разрешение и частоту кадров | Обрежьте лишнее и проверьте видимость рта. |
audio_url | Да | Новую речь и длину готовой временной шкалы | Подготовьте диалог отдельно; наши запуски использовали WAV и MP3. |
Входные изображения, встроенный синтез речи и sync_mode здесь не предлагаются. sync. описывает дополнительные варианты входа в собственном API; примеры оттуда не определяют набор принимаемых здесь полей.
Длина результата и расчёт стоимости
Оплата определяется секундами входного видео с округлением вверх; актуальная ставка показана на этой странице. Длина аудио не меняет оплачиваемый объём, даже если итоговый MP4 короче или длиннее исходника. Ролики вне диапазона отклоняются до списания, а неудачные генерации не оплачиваются.
Новая запись задаёт длину возвращаемого изображения. Короткая речь обрезает ролик; длинная продлевает его воспроизведением исходных кадров в обратном порядке от конца. Подгоните речь к длине плана, если обратное движение мешает: переключателя режима здесь нет.
Результаты тестов коротких роликов
В сводке от 13 ноября 2026 года указаны два коротких теста с такими длительностями и временем обработки. Они не определяют производительность на длинных видео и не ранжируют визуальное качество.
| Исходное видео | Речевой вход | Полученный MP4 | Обработка |
|---|---|---|---|
| 5,04 с, 1280×720, 24 кадра/с | 4,55 с WAV | 4,58 с, 1280×720, 24 кадра/с | Около 76 с |
| 5,00 с, 1358×680, 25 кадров/с | 6,48 с MP3 | 6,48 с, 1358×680, 25 кадров/с | Около 173 с |
Оба запуска сохранили размер изображения и частоту кадров исходника, звук на выходе — моно AAC. Тест WAV показывает, что длительность закодированного видео может немного отличаться от длины аудио.
Подготовка содержательной проверки качества
Возьмите характерный разговорный план и изолированную запись диалога. В руководстве по устранению проблем sync. рекомендует хорошо видимые освещённые лица и речь без музыки и перекрывающихся голосов.
- Выберите короткий дубль, имея разрешение на видео и голос.
- Подготовьте новую реплику и сравните её длину с изображением.
- Проверьте смыкания губ, повороты головы и проходящие возле рта руки.
- Просмотрите конец на обратное движение и прослушайте монофонический микс AAC.
Видео урока с переведённой записью — пара для локализации; дубль ведущего с исправленной фразой о продукте — пара для замены реплики. Подготовьте перевод и речь до вызова интерфейса.
Ограничения и устранение проблем
При неудачном запросе сначала проверьте длительность исходника и два URL. Диапазон видео — 1–300 секунд; удалите неподдерживаемые поля вроде sync_mode, не копируйте запрос из API разработчика целиком. При ошибке загрузки медиа убедитесь, что каждый адрес отдаёт нужный файл и доступен на протяжении обработки.
Если результат неожиданно короткий, обычно стоит проверить длину переданной речи. Обратное движение в конце соответствует описанному продлению при речи длиннее исходника. Для диагностики времени храните исходные файлы рядом с MP4.
Выбор lipsync-3 или соседней модели
Выбирайте модель синхронизации, проверяя одну и ту же разрешённую пару входных файлов у каждого кандидата.
| Вариант | Когда рассмотреть | Имеющиеся данные |
|---|---|---|
| lipsync-3 | Готовое видео с лицом и речь | Два замеренных коротких запуска. |
| lip-sync/v1 | Менее затратная синхронизация на SpicyAPI | Сравнительного теста качества или задержки нет. |
Для входного изображения, встроенного синтеза речи или выбора режима нужен другой API с явно описанными возможностями. Используйте видео и речь на законных основаниях и не выдавайте переозвученный результат за реального человека.
Быстрый старт API
# 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": "sync/lipsync-3/lip-sync",
"input": {
"audio_url": "https://example.com/reference.mp3",
"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.


