Используйте Volcengine Video Lip Sync через Rivya Public API v1: ID модели volcengine-video-lip-sync, поддерживаемые входные данные, параметры, правила Files API, кредиты и примеры ответов.

Доступно через APIГотовностьВидео

ID модели API

volcengine-video-lip-sync

Входные данные

file

Files API

Требуется для референсных режимов

Базовые кредиты

Ставка в кредитах: 8 / секунду входного материала Итоговая стоимость задачи округляется вверх до целых кредитов.

Возможность

Видео

Биллинг

METERED

Лимит промпта

Документированный лимит промпта отсутствует

Контракт запроса

Передавайте ID модели на верхнем уровне. Управляющие параметры конкретной модели размещайте в params.

Ключ	Тип	Обязательно	По умолчанию	Описание
model	string	Да	volcengine-video-lip-sync	Используйте volcengine-video-lip-sync как ID модели API.
prompt	string	Нет	-	Текст промпта для моделей, поддерживающих текстовый ввод.
params	object	Да	-	Объект параметров конкретной модели. Допустимые ключи указаны в таблице ниже.
client_request_id	string	Нет	-	Необязательный клиентский id для трассировки запросов в вашей системе.

Параметры модели

Ключ	Тип	Обязательно	По умолчанию	Диапазон	Варианты	Описание
mode	select	Да	lite	-	lite, basic	Lite подходит для материала с одним человеком анфас; Basic поддерживает более сложные сцены с одним человеком.
separate_vocal	select	Нет	false	-	false, true	Включите отделение голоса, если целевое аудио содержит фоновый звук, который следует подавить.
open_scenedet	select	Нет	false	-	false, true	Доступно только в режиме Basic для сегментации сцен и определения говорящего.
align_audio	select	Нет	true	-	true, false	Доступно только в режиме Lite. Зациклите видео, если аудио длиннее исходного материала.
align_audio_reverse	select	Нет	false	-	false, true	Доступно только в режиме Lite и требует включённого выравнивания аудио.
templ_start_seconds	number	Нет	0	min 0	-	Доступно только в режиме Lite. Выберите неотрицательное время начала в исходном видео.

Политика загрузки

Сначала загрузите референсные файлы, затем поместите возвращенный URL и токен длительности в params.referenceMediaItems.

Правило референсных материалов

Исходное видео и целевое аудио: Загрузите ровно одно видео MP4 или MOV размером до 95 MB и одну голосовую дорожку MP3, M4A, WAV, AAC или OGG размером до 10 MB.

Макс. файлов

Принимаемые типы файлов

video, audio

Токен длительности

Видео- и аудио-референсы должны передавать поле durationToken из /api/v1/files, когда требуется проверка длительности.

kind	Макс. размер	MIME-типы
video	95 MB	video/mp4, video/quicktime
audio	10 MB	audio/mpeg, audio/mp4, audio/wav, audio/x-wav, audio/aac, audio/ogg

Для этой модели не показан запускаемый пример Public API.

Запрос с референсным файлом

{
  "model": "volcengine-video-lip-sync",
  "params": {
    "mode": "lite",
    "separate_vocal": "false",
    "open_scenedet": "false",
    "align_audio": "true",
    "align_audio_reverse": "false",
    "templ_start_seconds": 0,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-video.mp4",
        "kind": "video",
        "name": "reference-video.mp4",
        "mimeType": "video/mp4",
        "durationSeconds": 8,
        "durationToken": "video_duration_token_from_files_api",
        "width": 1280,
        "height": 720,
        "sizeBytes": 8388608,
        "framesPerSecond": 30,
        "videoBitrateMbps": 8,
        "videoMetadataToken": "video_metadata_token_from_original_files_api_upload_response"
      },
      {
        "url": "https://cdn.example.com/reference-audio.wav",
        "kind": "audio",
        "name": "reference-audio.wav",
        "mimeType": "audio/wav",
        "durationSeconds": 12,
        "durationToken": "audio_duration_token_from_files_api"
      }
    ]
  }
}

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

Эндпоинт создания возвращает публичный id задачи. Опрашивайте эндпоинт статуса, пока задача не завершится успехом или ошибкой.

{
  "id": "task_volcengine_video_lip_sync_example",
  "status": "queued",
  "model": "volcengine-video-lip-sync",
  "reserved_credits": 8,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Распространенные ошибки

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Некоторым режимам нужны референсные файлы, загруженные через Files API.

Интеграция Volcengine Video Lip Sync API