Folosește Volcengine Video Lip Sync prin Rivya Public API v1 cu model id volcengine-video-lip-sync, intrări suportate, parametri, reguli Files API, credite și exemple de răspuns.

Disponibil prin APIDisponibilitateVideo

ID model API

volcengine-video-lip-sync

Intrări

file

Files API

Necesar pentru moduri de referință

Credite de bază

per_input_second · default=8 · ⌈total⌉

Capabilitate

Video

Facturare

METERED

Limită prompt

Nicio limită de prompt documentată

Contract cerere

Trimite model id la nivelul superior. Controalele specifice modelului aparțin în params.

Cheie	Tip	Necesar	Implicit	Descriere
model	string	Da	volcengine-video-lip-sync	Folosește ID-ul de model API volcengine-video-lip-sync.
prompt	string	Nu	-	Text de prompt pentru modelele care suportă intrare text.
params	object	Da	-	Obiect de parametri specific modelului. Folosește rândurile de mai jos pentru cheile permise.
client_request_id	string	Nu	-	ID opțional din partea clientului pentru urmărirea cererilor în sistemul tău.

Parametri model

Cheie	Tip	Necesar	Implicit	Interval	Opțiuni	Descriere
mode	select	Da	lite	-	lite, basic	Lite este potrivit pentru filmări frontale cu o singură persoană; Basic acceptă scene mai complexe cu o singură persoană.
separate_vocal	select	Nu	false	-	false, true	Activează separarea vocală când sunetul țintă include sunete de fundal care ar trebui suprimate.
open_scenedet	select	Nu	false	-	false, true	Disponibilă doar în modul Basic pentru segmentarea scenelor și identificarea vorbitorului.
align_audio	select	Nu	true	-	true, false	Disponibil doar în modul Lite. Redă videoclipul în buclă atunci când sunetul este mai lung decât materialul sursă.
align_audio_reverse	select	Nu	false	-	false, true	Disponibilă doar în modul Lite și necesită ca alinierea audio să fie activată.
templ_start_seconds	number	Nu	0	min 0	-	Disponibil doar în modul Lite. Alege un moment de început nenegativ în videoclipul sursă.

Politică de încărcare

Încarcă mai întâi fișierele de referință, apoi pune URL-ul returnat și duration token în params.referenceMediaItems.

Regulă referință

Video sursă și audio țintă: Încarcă exact un videoclip MP4 sau MOV de cel mult 95 MB și o pistă vocală MP3, M4A, WAV, AAC ori OGG de cel mult 10 MB.

Max fișiere

Tipuri de fișiere acceptate

video, audio

Duration token

Referințele video și audio ar trebui să includă durationToken din /api/v1/files când verificarea duratei este necesară.

kind	Dimensiune max	Tipuri MIME
video	95 MB	video/mp4, video/quicktime
audio	10 MB	audio/mpeg, audio/mp4, audio/wav, audio/x-wav, audio/aac, audio/ogg

Cerere minimă

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

Cerere cu fișier de referință

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

Răspuns create

Endpointul create returnează un task id public. Interoghează endpointul de stare până când sarcina reușește sau eșuează.

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

Erori comune

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Unele moduri necesită încărcări de referință prin Files API.

Integrare API Volcengine Video Lip Sync