Rivya Public API v1 के जरिए मॉडल ID volcengine-video-lip-sync, समर्थित इनपुट, पैरामीटर, Files API नियम, क्रेडिट और रिस्पॉन्स उदाहरणों के साथ Volcengine Video Lip Sync का उपयोग करें।

API से उपलब्धउपलब्धता स्थितिवीडियो

API मॉडल ID

volcengine-video-lip-sync

इनपुट

file

Files API

संदर्भ मोड के लिए जरूरी

बेस क्रेडिट

per_input_second · default=8 · ⌈total⌉

क्षमता

वीडियो

बिलिंग

METERED

प्रॉम्प्ट सीमा

प्रॉम्प्ट सीमा दर्ज नहीं है

रिक्वेस्ट संरचना

मॉडल ID को शीर्ष स्तर पर भेजें। मॉडल के लिए खास कंट्रोल params में रखें।

कुंजी	प्रकार	जरूरी	डिफॉल्ट	विवरण
model	string	हां	volcengine-video-lip-sync	volcengine-video-lip-sync API मॉडल ID का उपयोग करें।
prompt	string	नहीं	-	टेक्स्ट इनपुट समर्थित मॉडल के लिए प्रॉम्प्ट टेक्स्ट।
params	object	हां	-	मॉडल के लिए खास पैरामीटर ऑब्जेक्ट। अनुमत key के लिए नीचे दी गई पंक्तियां देखें।
client_request_id	string	नहीं	-	अपने सिस्टम में रिक्वेस्ट ट्रेस करने के लिए वैकल्पिक क्लाइंट-साइड 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 और durationToken को params.referenceMediaItems में रखें।

संदर्भ नियम

स्रोत वीडियो और लक्षित ऑडियो: अधिकतम 95 MB का ठीक एक MP4 या MOV वीडियो और अधिकतम 10 MB का एक MP3, M4A, WAV, AAC या OGG वोकल ट्रैक अपलोड करें।

अधिकतम फाइलें

स्वीकार्य फाइल प्रकार

video, audio

durationToken

अवधि सत्यापन जरूरी होने पर वीडियो और ऑडियो संदर्भों में /api/v1/files से मिला durationToken होना चाहिए।

kind	अधिकतम आकार	MIME प्रकार
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"
      }
    ]
  }
}

Create रिस्पॉन्स

create एंडपॉइंट सार्वजनिक टास्क ID लौटाता है। टास्क सफल या विफल होने तक स्टेटस एंडपॉइंट पोल करें।

{
  "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 संदर्भ अपलोड जरूरी हैं।

Volcengine Video Lip Sync API इंटीग्रेशन