Gunakan Volcengine Video Lip Sync melalui Rivya Public API v1 dengan id model volcengine-video-lip-sync, input yang didukung, parameter, aturan Files API, kredit, dan contoh response.

Tersedia via APIKesiapanVideo

ID model API

volcengine-video-lip-sync

Input

file

Files API

Diperlukan untuk mode referensi

Kredit dasar

per_input_second · default=8 · ⌈total⌉

Kapabilitas

Video

Tagihan

METERED

Batas prompt

Tidak ada batas prompt terdokumentasi

Kontrak request

Kirim id model di level atas. Kontrol khusus model berada di params.

Key	Tipe	Wajib	Default	Deskripsi
model	string	Ya	volcengine-video-lip-sync	Gunakan volcengine-video-lip-sync sebagai id model API.
prompt	string	Tidak	-	Teks prompt untuk model yang mendukung input teks.
params	object	Ya	-	Objek parameter khusus model. Gunakan baris di bawah untuk key yang diizinkan.
client_request_id	string	Tidak	-	ID sisi klien opsional untuk melacak request di sistem Anda.

Parameter model

Key	Tipe	Wajib	Default	Rentang	Opsi	Deskripsi
mode	select	Ya	lite	-	lite, basic	Lite cocok untuk rekaman satu orang yang menghadap ke depan; Basic mendukung adegan satu orang yang lebih kompleks.
separate_vocal	select	Tidak	false	-	false, true	Aktifkan pemisahan vokal saat audio target menyertakan suara latar yang perlu ditekan.
open_scenedet	select	Tidak	false	-	false, true	Hanya tersedia dalam mode Basic untuk segmentasi adegan dan identifikasi pembicara.
align_audio	select	Tidak	true	-	true, false	Hanya tersedia dalam mode Lite. Ulangi video saat audio lebih panjang daripada rekaman sumber.
align_audio_reverse	select	Tidak	false	-	false, true	Hanya tersedia dalam mode Lite dan mengharuskan penyelarasan audio aktif.
templ_start_seconds	number	Tidak	0	min 0	-	Hanya tersedia dalam mode Lite. Pilih waktu mulai yang tidak negatif dalam video sumber.

Kebijakan unggahan

Unggah file referensi terlebih dahulu, lalu tempatkan URL dan duration token yang dikembalikan ke dalam params.referenceMediaItems.

Aturan referensi

Video sumber dan audio target: Unggah tepat satu video MP4 atau MOV berukuran hingga 95 MB dan satu trek vokal MP3, M4A, WAV, AAC, atau OGG berukuran hingga 10 MB.

File maksimum

Jenis file yang diterima

video, audio

Duration token

Referensi video dan audio harus membawa durationToken dari /api/v1/files saat verifikasi durasi diperlukan.

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

Request minimal

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

Request file referensi

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

Response create

Endpoint create mengembalikan public task id. Poll endpoint status sampai tugas berhasil 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
}

Error umum

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Beberapa mode membutuhkan unggahan referensi Files API.

Integrasi API Volcengine Video Lip Sync