Volcengine Video Lip Sync modelini Rivya Public API v1 üzerinden model id volcengine-video-lip-sync, desteklenen girişler, parametreler, Files API kuralları, krediler ve yanıt örnekleriyle kullanın.

API üzerinden kullanılabilirHazırlıkVideo

API model kimliği

volcengine-video-lip-sync

Girişler

file

Files API

Referans modları için gerekli

Temel krediler

per_input_second · default=8 · ⌈total⌉

Yetenek

Video

Faturalandırma

METERED

Prompt limiti

Belgelenmiş prompt limiti yok

İstek sözleşmesi

Model id değerini en üst seviyede gönderin. Modele özel kontroller params içine aittir.

Anahtar	Tür	Gerekli	Varsayılan	Açıklama
model	string	Evet	volcengine-video-lip-sync	volcengine-video-lip-sync API model kimliği değerini kullanın.
prompt	string	Hayır	-	Metin girişini destekleyen modeller için prompt metni.
params	object	Evet	-	Modele özel parametre nesnesi. İzin verilen anahtarlar için aşağıdaki satırları kullanın.
client_request_id	string	Hayır	-	Sisteminizde istekleri izlemek için isteğe bağlı istemci tarafı id.

Model parametreleri

Anahtar	Tür	Gerekli	Varsayılan	Aralık	Seçenekler	Açıklama
mode	select	Evet	lite	-	lite, basic	Lite, kameraya dönük tek kişilik görüntülere uygundur; Basic daha karmaşık tek kişilik sahneleri destekler.
separate_vocal	select	Hayır	false	-	false, true	Hedef ses bastırılması gereken arka plan sesi içeriyorsa vokal ayırmayı etkinleştirin.
open_scenedet	select	Hayır	false	-	false, true	Yalnızca Basic modunda sahne bölümleme ve konuşmacı tanımlama için kullanılabilir.
align_audio	select	Hayır	true	-	true, false	Yalnızca Lite modunda kullanılabilir. Ses kaynak görüntüden uzunsa videoyu döngüye alın.
align_audio_reverse	select	Hayır	false	-	false, true	Yalnızca Lite modunda kullanılabilir ve ses hizalamanın açık olmasını gerektirir.
templ_start_seconds	number	Hayır	0	min 0	-	Yalnızca Lite modunda kullanılabilir. Kaynak videoda negatif olmayan bir başlangıç zamanı seçin.

Yükleme politikası

Önce referans dosyalarını yükleyin, ardından dönen URLyi ve duration token değerini params.referenceMediaItems içine yerleştirin.

Referans kuralı

Kaynak video ve hedef ses: En fazla 95 MB boyutunda tam olarak bir MP4 veya MOV video ve en fazla 10 MB boyutunda bir MP3, M4A, WAV, AAC ya da OGG ses kaydı yükleyin.

Maks. dosya

Kabul edilen dosya türleri

video, audio

Süre belirteci

Süre doğrulaması gerektiğinde video ve ses referansları /api/v1/files içinden durationToken taşımalıdır.

kind	Maks. boyut	MIME türleri
video	95 MB	video/mp4, video/quicktime
audio	10 MB	audio/mpeg, audio/mp4, audio/wav, audio/x-wav, audio/aac, audio/ogg

Minimal istek

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

Referans dosyalı istek

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

Create yanıtı

Create endpointi herkese açık task id döndürür. Görev başarılı veya başarısız olana kadar status endpointini sorgulayın.

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

Yaygın hatalar

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Bazı modlar Files API referans yüklemeleri gerektirir.

Volcengine Video Lip Sync API Entegrasyonu