Dùng Volcengine Video Lip Sync qua Rivya Public API v1 với ID mô hình volcengine-video-lip-sync, đầu vào được hỗ trợ, tham số, quy tắc Files API, tín dụng và ví dụ phản hồi.

Khả dụng qua APIĐộ sẵn sàngVideo

ID mô hình API

volcengine-video-lip-sync

Đầu vào

file

Files API

Bắt buộc cho chế độ tham chiếu

Tín dụng cơ bản

per_input_second · default=8 · ⌈total⌉

Năng lực

Video

Thanh toán

METERED

Giới hạn prompt

Không có giới hạn prompt được ghi

Quy ước yêu cầu

Gửi ID mô hình ở cấp trên cùng. Điều khiển riêng của mô hình nằm trong params.

Key	Loại	Bắt buộc	Mặc định	Mô tả
model	string	Có	volcengine-video-lip-sync	Dùng volcengine-video-lip-sync làm ID mô hình API.
prompt	string	Không	-	Văn bản prompt cho mô hình hỗ trợ đầu vào văn bản.
params	object	Có	-	Đối tượng tham số riêng của mô hình. Dùng các dòng bên dưới để xem key được phép.
client_request_id	string	Không	-	ID phía client không bắt buộc để theo dõi yêu cầu trong hệ thống của bạn.

Tham số mô hình

Key	Loại	Bắt buộc	Mặc định	Phạm vi	Tùy chọn	Mô tả
mode	select	Có	lite	-	lite, basic	Lite phù hợp với cảnh một người nhìn thẳng; Basic hỗ trợ cảnh một người phức tạp hơn.
separate_vocal	select	Không	false	-	false, true	Bật tách giọng khi âm thanh mục tiêu có âm nền cần được hạn chế.
open_scenedet	select	Không	false	-	false, true	Chỉ có trong chế độ Basic cho phân đoạn cảnh và nhận diện người nói.
align_audio	select	Không	true	-	true, false	Chỉ có trong chế độ Lite. Lặp video khi âm thanh dài hơn cảnh nguồn.
align_audio_reverse	select	Không	false	-	false, true	Chỉ có trong chế độ Lite và yêu cầu bật căn chỉnh âm thanh.
templ_start_seconds	number	Không	0	min 0	-	Chỉ có trong chế độ Lite. Chọn thời điểm bắt đầu không âm trong video nguồn.

Chính sách tải lên

Trước tiên tải tệp tham chiếu lên, rồi đặt URL và duration token được trả về vào params.referenceMediaItems.

Quy tắc tham chiếu

Video nguồn và âm thanh mục tiêu: Tải lên đúng một video MP4 hoặc MOV tối đa 95 MB và một bản thu giọng MP3, M4A, WAV, AAC hoặc OGG tối đa 10 MB.

Số tệp tối đa

Loại tệp được chấp nhận

video, audio

Token thời lượng

Tham chiếu video và audio nên mang durationToken từ /api/v1/files khi cần xác minh thời lượng.

kind	Kích thước tối đa	Loại MIME
video	95 MB	video/mp4, video/quicktime
audio	10 MB	audio/mpeg, audio/mp4, audio/wav, audio/x-wav, audio/aac, audio/ogg

Yêu cầu tối thiểu

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

Yêu cầu có tệp tham chiếu

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

Phản hồi tạo

Điểm cuối tạo trả về ID tác vụ công khai. Hãy thăm dò điểm cuối trạng thái cho đến khi tác vụ succeeded hoặc failed.

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

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Một số chế độ cần tải tệp tham chiếu qua Files API.

Tích hợp API Volcengine Video Lip Sync