Gunakan Volcengine Video Lip Sync melalui Rivya Public API v1 dengan ID model volcengine-video-lip-sync, input disokong, parameter, peraturan Files API, kredit dan contoh respons.

Tersedia melalui APIKesediaanVideo

ID model API

volcengine-video-lip-sync

Input

file

Files API

Diperlukan untuk mod rujukan

Kredit asas

per_input_second · default=8 · ⌈total⌉

Keupayaan

Video

Bil

METERED

Had prompt

Tiada had prompt didokumenkan

Kontrak permintaan

Hantar ID model pada peringkat atas. Kawalan khusus model berada dalam params.

Kunci	Jenis	Wajib	Lalai	Penerangan
model	string	Ya	volcengine-video-lip-sync	Gunakan ID model API volcengine-video-lip-sync.
prompt	string	Tidak	-	Teks prompt untuk model yang menyokong input teks.
params	object	Ya	-	Objek parameter khusus model. Gunakan baris di bawah untuk kunci yang dibenarkan.
client_request_id	string	Tidak	-	ID sisi klien pilihan untuk menjejak permintaan dalam sistem anda.

Parameter model

Kunci	Jenis	Wajib	Lalai	Julat	Pilihan	Penerangan
mode	select	Ya	lite	-	lite, basic	Lite sesuai untuk rakaman seorang yang menghadap kamera; Basic menyokong adegan seorang yang lebih kompleks.
separate_vocal	select	Tidak	false	-	false, true	Hidupkan pemisahan vokal apabila audio sasaran mengandungi bunyi latar yang patut ditekan.
open_scenedet	select	Tidak	false	-	false, true	Hanya tersedia dalam mod Basic untuk pembahagian adegan dan pengenalpastian penutur.
align_audio	select	Tidak	true	-	true, false	Hanya tersedia dalam mod Lite. Ulang video apabila audio lebih panjang daripada rakaman sumber.
align_audio_reverse	select	Tidak	false	-	false, true	Hanya tersedia dalam mod Lite dan memerlukan penjajaran audio dihidupkan.
templ_start_seconds	number	Tidak	0	min 0	-	Hanya tersedia dalam mod Lite. Pilih masa mula bukan negatif dalam video sumber.

Polisi muat naik

Muat naik fail rujukan dahulu, kemudian letakkan URL dan token durasi yang dikembalikan dalam params.referenceMediaItems.

Peraturan rujukan

Video sumber dan audio sasaran: Muat naik tepat satu video MP4 atau MOV sehingga 95 MB dan satu trek vokal MP3, M4A, WAV, AAC atau OGG sehingga 10 MB.

Fail maksimum

Jenis fail diterima

video, audio

Token durasi

Rujukan video dan audio patut membawa durationToken daripada /api/v1/files apabila pengesahan durasi diperlukan.

kind	Saiz maksimum	Jenis MIME
video	95 MB	video/mp4, video/quicktime
audio	10 MB	audio/mpeg, audio/mp4, audio/wav, audio/x-wav, audio/aac, audio/ogg

Permintaan minimum

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

Permintaan fail rujukan

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

Respons cipta

Endpoint cipta mengembalikan ID tugasan awam. Semak endpoint status sehingga tugasan berjaya atau gagal.

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

Ralat biasa

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Sesetengah mod memerlukan muat naik rujukan Files API.

Integrasi API Volcengine Video Lip Sync