ГлавнаяМоделиГенерация видеоPixVerse Lipsync

PixVerse Lipsync API

ПровайдерPixverse

pixverse-lipsync-1 — генерация видео-модель от Pixverse.

asyncimage_to_videotext_to_video

Попробуйте прямо здесь

PixVerse Lipsync Открыть в песочнице

Что умеет PixVerse Lipsync

  • Async
  • Видео из изображения
  • Видео по тексту

Стоимость

за секунду
per second of audio
1.8 ₽

Цены указаны в рублях и списываются с баланса проекта за успешные запросы. Надбавки (+) суммируются с базовой ставкой.

Технические характеристики

Vendor
pixverse
Modality
video

PixVerse Lipsync API для синхронизации речи и движений губ

PixVerse Lipsync — модель от PixVerse для точной синхронизации речи с движениями губ в готовом видео. Она анализирует аудиодорожку и артикуляцию персонажа, делая диалоги, озвучку и локализацию роликов более естественными. Для работы можно использовать видео и аудиофайлы либо текст с TTS-голосом; поддерживаются пользовательские голоса. Через Ranvik API модель удобно подключать к продуктам и контентным сценариям единым ключом.

Параметры запроса

Параметры, которые принимает модель. Передаются в теле запроса.

ПараметрТипДиапазон / значенияПо умолчаниюОписание
inputs.referenceVideosreq
array of strings
min: 1 · max: 1
—
Источник персонажа / лица (UUID / URL). Только 1 элемент. Модель синхронизирует движение губ персонажа с аудио, сохраняя выражение лица.
1 пример
Примеры
[
  "https://example.com/character.mp4"
]
inputs.audio
string
—
—
Готовая аудио-дорожка с речью (UUID / URL). Используется в режиме A. Несовместимо с speech.text — выбери ОДИН источник аудио.
1 пример
Примеры
https://example.com/dialogue.mp3
speech.text
string
max: 200
—
Текст для синтеза речи (TTS). Лимит 200 символов. Используется в режиме B (вместо inputs.audio). Требует speech.voice.
1 пример
Примеры
Hello, welcome to my channel. Today we will explore something amazing.
speech.voice
enum
Emily, James, Isabella, Liam, Chloe, Adrian, Harper, Ava, Sophia, Julia, Mason, Jack, Oliver, Ethan, auto
auto
Выбор голоса для TTS. 14 предустановленных голосов + auto (модель решит сама).
numberResults
integer
min: 1 · max: 4
1
Сколько вариаций сгенерировать (разные seeds). Каждая считается отдельно.
outputFormat
enum
MP4, WEBM, MOV
MP4
Контейнер для финального видео.
outputQuality
integer
min: 20 · max: 99
95
Качество компрессии (20–99). Выше — лучше визуально и больше размер файла.
safety.checkContent
boolean
—
false
Включить проверку контента на NSFW / запрещёнку. При true default-режим safety.mode становится fast.
safety.mode
enum
none, fast, full
none
Режим safety-сканера: none — выключен, fast — проверяет ключевые кадры, full — все кадры (медленнее).
webhookURL
string
—
—
URL для POST-уведомления при готовности задачи. При numberResults > 1 webhook триггерится на каждый результат отдельно.
1 пример
Примеры
https://yourapp.com/webhooks/runware
uploadEndpoint
string
—
—
Presigned URL (S3 / GCS / Azure / HTTP PUT) для автозагрузки готового видео. Сырое binary в body PUT-запроса.
1 пример
Примеры
https://bucket.s3.amazonaws.com/result.mp4?X-Amz-Signature=...

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

Что возвращает API. У медиа-моделей формат зависит от режима: sync — сразу результат, async — task_id для опроса через GET /v1/tasks/{id}. Эта модель работает только в async-режиме.

Async (HTTP 202)

HTTP 202. Видео-генерация всегда async — нет sync-режима.

ПолеТипЗначенияОписание
id
string
—
task_id для GET /v1/tasks/{id}.
object
string
video.task
status
enum
queued, processing, completed, failed
model
string
—
created
integer
—

Опрос статуса (GET /v1/tasks/{id})

GET /v1/tasks/{id} — опрос статуса.

ПолеТипЗначенияОписание
id
string
—
status
enum
queued, processing, completed, failed, canceled
modality
string
video
model
string
—
data
array
—
Каждый элемент:
  • url— string · CDN URL .mp4 / .webm / .mov.
error
string
—

Пример кода

pixverse-lipsync-1_example.py
from openai import OpenAI

client = OpenAI(api_key="rk_live_...", base_url="https://api.ranvik.ru/v1")
resp = client.videos.generate(
    model= "pixverse-lipsync-1",
    numberResults= 1,
    outputFormat= "MP4",
    outputQuality= 95,
    webhookURL= "https://example.com/...",
    uploadEndpoint= "value",
    inputs= {
        "referenceVideos": [],
        "audio": "Пример промпта"
    },
    speech= {
        "text": "Пример промпта",
        "voice": "auto"
    },
    safety= {
        "checkContent": False,
        "mode": "none"
    },
)
print(resp)
Полная документация модели

Частые вопросы о PixVerse Lipsync

PixVerse Lipsync — модель PixVerse для синхронизации речи и движений губ в видео. Она помогает превратить готовый ролик в убедительное говорящее видео.
Она нужна для озвучивания аватаров, локализации роликов, обучающих материалов и рекламы: новая аудиодорожка согласуется с артикуляцией персонажа.
Получите ключ в личном кабинете Ranvik API: сервис объединяет модели в одном интерфейсе, дает документацию и примеры запросов для быстрого старта.
Зарегистрируйтесь в Ranvik API, создайте ключ, загрузите видео и аудио либо передайте текст для озвучки. Сервис доступен в России без VPN.
Да. В Ranvik API баланс пополняется в рублях; доступны банковские карты, СБП и безналичный расчет для бизнеса. Расходы списываются по факту.
Для задачи подходят ролики MP4, MOV и WebM, а для речи — MP3, WAV, M4A или AAC. Для стабильного результата используйте четкий голос и лицо в кадре.