Utilisez Volcengine Video Lip Sync via Rivya Public API v1 avec le model id volcengine-video-lip-sync, les entrées prises en charge, les paramètres, les règles Files API, les crédits et des exemples de réponse.

Disponible via APIDisponibilitéVidéo

ID de modèle API

volcengine-video-lip-sync

Entrées

file

Files API

Requis pour les modes avec référence

Crédits de base

per_input_second · default=8 · ⌈total⌉

Capacité

Vidéo

Facturation

METERED

Limite de prompt

Aucune limite de prompt documentée

Contrat de requête

Envoyez l'ID du modèle au niveau supérieur. Les contrôles propres au modèle vont dans params.

Clé	Type	Obligatoire	Par défaut	Description
model	string	Oui	volcengine-video-lip-sync	Utilisez volcengine-video-lip-sync comme ID de modèle API.
prompt	string	Non	-	Texte de prompt pour les modèles qui prennent en charge l'entrée texte.
params	object	Oui	-	Objet de paramètres propre au modèle. Consultez les lignes ci-dessous pour les clés autorisées.
client_request_id	string	Non	-	ID côté client facultatif pour tracer les requêtes dans votre système.

Paramètres du modèle

Clé	Type	Obligatoire	Par défaut	Plage	Options	Description
mode	select	Oui	lite	-	lite, basic	Lite convient aux séquences d’une seule personne face à la caméra ; Basic prend en charge des scènes plus complexes avec une seule personne.
separate_vocal	select	Non	false	-	false, true	Activez la séparation vocale lorsque l’audio cible contient un fond sonore à atténuer.
open_scenedet	select	Non	false	-	false, true	Disponible uniquement en mode Basic pour la segmentation des scènes et l’identification du locuteur.
align_audio	select	Non	true	-	true, false	Disponible uniquement en mode Lite. Lire la vidéo en boucle lorsque l’audio est plus long que la séquence source.
align_audio_reverse	select	Non	false	-	false, true	Disponible uniquement en mode Lite et exige que l’alignement audio soit activé.
templ_start_seconds	number	Non	0	min 0	-	Disponible uniquement en mode Lite. Choisissez un instant de début positif ou nul dans la vidéo source.

Règle d'importation

Importez d'abord les fichiers de référence, puis placez l'URL renvoyée et le durationToken dans params.referenceMediaItems.

Règle de référence

Vidéo source et audio cible: Importez exactement une vidéo MP4 ou MOV de 95 MB maximum et une piste vocale MP3, M4A, WAV, AAC ou OGG de 10 MB maximum.

Nombre max. de fichiers

Types de fichier acceptés

video, audio

Duration token

Les références vidéo et audio doivent inclure durationToken depuis /api/v1/files lorsqu'une vérification de durée est requise.

kind	Taille max.	Types MIME
video	95 MB	video/mp4, video/quicktime
audio	10 MB	audio/mpeg, audio/mp4, audio/wav, audio/x-wav, audio/aac, audio/ogg

Requête minimale

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

Requête avec fichier de référence

{
  "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éponse de création

L'endpoint de création renvoie un ID de tâche public. Interrogez l'endpoint de statut jusqu'à ce que la tâche réussisse ou échoue.

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

Erreurs courantes

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Certains modes exigent des importations de référence via Files API.

Intégration API Volcengine Video Lip Sync