Używaj Volcengine Video Lip Sync przez Rivya Public API v1 z identyfikatorem modelu volcengine-video-lip-sync, obsługiwanymi wejściami, parametrami, regułami Files API, kredytami i przykładami odpowiedzi.

Dostępne przez APIGotowośćWideo

Identyfikator modelu API

volcengine-video-lip-sync

Wejścia

file

Files API

Wymagane dla trybów referencyjnych

Kredyty bazowe

per_input_second · default=8 · ⌈total⌉

Możliwość

Wideo

Rozliczenia

METERED

Limit promptu

Brak udokumentowanego limitu promptu

Kontrakt żądania

Wyślij identyfikator modelu na najwyższym poziomie. Kontrolki specyficzne dla modelu należą do params.

Klucz	Typ	Wymagane	Domyślnie	Opis
model	string	Tak	volcengine-video-lip-sync	Użyj volcengine-video-lip-sync jako identyfikatora modelu API.
prompt	string	Nie	-	Tekst promptu dla modeli obsługujących wejście tekstowe.
params	object	Tak	-	Obiekt parametrów specyficznych dla modelu. Dozwolone klucze znajdziesz w wierszach poniżej.
client_request_id	string	Nie	-	Opcjonalny identyfikator po stronie klienta do śledzenia żądań w Twoim systemie.

Parametry modelu

Klucz	Typ	Wymagane	Domyślnie	Zakres	Opcje	Opis
mode	select	Tak	lite	-	lite, basic	Lite pasuje do frontalnego materiału z jedną osobą; Basic obsługuje bardziej złożone sceny z jedną osobą.
separate_vocal	select	Nie	false	-	false, true	Włącz oddzielanie głosu, gdy docelowe audio zawiera dźwięk tła, który należy stłumić.
open_scenedet	select	Nie	false	-	false, true	Dostępne tylko w trybie Basic do segmentacji scen i identyfikacji mówcy.
align_audio	select	Nie	true	-	true, false	Dostępne tylko w trybie Lite. Zapętlaj wideo, gdy audio jest dłuższe od materiału źródłowego.
align_audio_reverse	select	Nie	false	-	false, true	Dostępne tylko w trybie Lite i wymaga włączonego dopasowania audio.
templ_start_seconds	number	Nie	0	min 0	-	Dostępne tylko w trybie Lite. Wybierz nieujemny czas początku w wideo źródłowym.

Zasady przesyłania

Najpierw prześlij pliki referencyjne, a potem umieść zwrócony URL i token czasu trwania w params.referenceMediaItems.

Reguła referencji

Wideo źródłowe i docelowe audio: Prześlij dokładnie jedno wideo MP4 lub MOV o rozmiarze do 95 MB i jedną ścieżkę głosową MP3, M4A, WAV, AAC albo OGG o rozmiarze do 10 MB.

Maks. plików

Akceptowane rodzaje plików

video, audio

Token czasu trwania

Referencje wideo i audio powinny zawierać durationToken z /api/v1/files, gdy wymagana jest weryfikacja czasu trwania.

kind	Maks. rozmiar	Typy MIME
video	95 MB	video/mp4, video/quicktime
audio	10 MB	audio/mpeg, audio/mp4, audio/wav, audio/x-wav, audio/aac, audio/ogg

Żądanie minimalne

{
  "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
  }
}

Żądanie z plikiem referencyjnym

{
  "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"
      }
    ]
  }
}

Odpowiedź tworzenia

Endpoint tworzenia zwraca publiczny identyfikator zadania. Odpytuj endpoint statusu, aż zadanie zakończy się powodzeniem albo błędem.

{
  "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
}

Typowe błędy

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Niektóre tryby wymagają przesłania materiałów referencyjnych przez Files API.

Integracja API Volcengine Video Lip Sync