Χρησιμοποιήστε το Volcengine Video Lip Sync μέσω του Rivya Public API v1 με αναγνωριστικό μοντέλου volcengine-video-lip-sync, υποστηριζόμενες εισόδους, παραμέτρους, κανόνες Files API, credits και παραδείγματα απόκρισης.

Διαθέσιμο μέσω APIΕτοιμότηταΒίντεο

ID μοντέλου API

volcengine-video-lip-sync

Είσοδοι

file

Files API

Απαιτείται για λειτουργίες αναφοράς

Βασικές πιστώσεις

per_input_second · default=8 · ⌈total⌉

Δυνατότητα

Βίντεο

Χρέωση

METERED

Όριο prompt

Δεν υπάρχει τεκμηριωμένο όριο prompt

Σύμβαση αιτήματος

Στείλτε το αναγνωριστικό μοντέλου στο ανώτερο επίπεδο. Οι έλεγχοι που είναι ειδικοί για το μοντέλο ανήκουν στο params.

Κλειδί	Τύπος	Υποχρεωτικό	Προεπιλογή	Περιγραφή
model	string	Ναι	volcengine-video-lip-sync	Χρησιμοποιήστε το volcengine-video-lip-sync ως αναγνωριστικό μοντέλου API.
prompt	string	Όχι	-	Κείμενο προτροπής για μοντέλα που υποστηρίζουν είσοδο κειμένου.
params	object	Ναι	-	Αντικείμενο παραμέτρων ειδικό για το μοντέλο. Χρησιμοποιήστε τις παρακάτω γραμμές για τα επιτρεπόμενα κλειδιά.
client_request_id	string	Όχι	-	Προαιρετικό client-side id για ιχνηλάτηση αιτημάτων στο δικό σας σύστημα.

Παράμετροι μοντέλου

Κλειδί	Τύπος	Υποχρεωτικό	Προεπιλογή	Εύρος	Επιλογές	Περιγραφή
mode	select	Ναι	lite	-	lite, basic	Η Lite ταιριάζει σε μετωπικό υλικό ενός ατόμου· η Basic υποστηρίζει πιο σύνθετες σκηνές ενός ατόμου.
separate_vocal	select	Όχι	false	-	false, true	Ενεργοποιήστε τον διαχωρισμό φωνής όταν ο στοχευμένος ήχος περιλαμβάνει ήχο περιβάλλοντος που πρέπει να κατασταλεί.
open_scenedet	select	Όχι	false	-	false, true	Διατίθεται μόνο στη λειτουργία Basic για τμηματοποίηση σκηνής και αναγνώριση ομιλητή.
align_audio	select	Όχι	true	-	true, false	Διατίθεται μόνο στη λειτουργία Lite. Επαναλάβετε το βίντεο όταν ο ήχος είναι μεγαλύτερος από το πηγαίο υλικό.
align_audio_reverse	select	Όχι	false	-	false, true	Διατίθεται μόνο στη λειτουργία Lite και απαιτεί ενεργή ευθυγράμμιση ήχου.
templ_start_seconds	number	Όχι	0	min 0	-	Διατίθεται μόνο στη λειτουργία Lite. Επιλέξτε μη αρνητικό χρόνο έναρξης στο πηγαίο βίντεο.

Πολιτική μεταφόρτωσης

Ανεβάστε πρώτα αρχεία αναφοράς και μετά τοποθετήστε το URL που επιστράφηκε και το duration token μέσα στο params.referenceMediaItems.

Κανόνας αναφοράς

Πηγαίο βίντεο και στοχευμένος ήχος: Ανεβάστε ακριβώς ένα βίντεο MP4 ή MOV έως 95 MB και ένα φωνητικό κομμάτι MP3, M4A, WAV, AAC ή OGG έως 10 MB.

Μέγιστος αριθμός αρχείων

Αποδεκτοί τύποι αρχείων

video, audio

Token διάρκειας

Οι αναφορές βίντεο και ήχου πρέπει να μεταφέρουν `durationToken` από το /api/v1/files όταν απαιτείται επαλήθευση διάρκειας.

kind	Μέγιστο μέγεθος	MIME types
video	95 MB	video/mp4, video/quicktime
audio	10 MB	audio/mpeg, audio/mp4, audio/wav, audio/x-wav, audio/aac, audio/ogg

Ελάχιστο αίτημα

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

Αίτημα με αρχείο αναφοράς

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

Απόκριση δημιουργίας

Το τελικό σημείο δημιουργίας επιστρέφει δημόσιο αναγνωριστικό εργασίας. Ελέγχετε περιοδικά το τελικό σημείο κατάστασης μέχρι η εργασία να ολοκληρωθεί με επιτυχία ή να αποτύχει.

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

Συνηθισμένα σφάλματα

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Ορισμένες λειτουργίες απαιτούν μεταφορτώσεις αναφοράς μέσω Files API.

Ενσωμάτωση API για Volcengine Video Lip Sync