Rivya Public API v1 দিয়ে Volcengine Video Lip Sync ব্যবহার করুন: model id volcengine-video-lip-sync, সমর্থিত ইনপুট, প্যারামিটার, Files API নিয়ম, ক্রেডিট এবং response উদাহরণসহ।

API দিয়ে উপলভ্যপ্রস্তুতিভিডিও

API model id

volcengine-video-lip-sync

ইনপুট

file

Files API

reference mode-এর জন্য প্রয়োজন

বেস ক্রেডিট

per_input_second · default=8 · ⌈total⌉

ক্ষমতা

ভিডিও

বিলিং

METERED

প্রম্পট সীমা

নথিভুক্ত prompt limit নেই

রিকোয়েস্ট contract

model id top level-এ পাঠান। Model-specific control params-এ থাকবে।

Key	ধরন	প্রয়োজনীয়	ডিফল্ট	বিবরণ
model	string	হ্যাঁ	volcengine-video-lip-sync	volcengine-video-lip-sync API model id ব্যবহার করুন।
prompt	string	না	-	টেক্সট ইনপুট সমর্থন করে এমন model-এর prompt text।
params	object	হ্যাঁ	-	মডেল-নির্দিষ্ট প্যারামিটার object। অনুমোদিত key-এর জন্য নিচের row ব্যবহার করুন।
client_request_id	string	না	-	আপনার সিস্টেমে request trace করার ঐচ্ছিক client-side id।

মডেল প্যারামিটার

Key	ধরন	প্রয়োজনীয়	ডিফল্ট	পরিসর	বিকল্প	বিবরণ
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 মোডে পাওয়া যায়। উৎস ভিডিওতে শূন্য বা তার বেশি শুরু সময় বেছে নিন।

আপলোড নীতি

প্রথমে reference file upload করুন, তারপর ফেরত পাওয়া URL এবং duration token params.referenceMediaItems-এর মধ্যে দিন।

রেফারেন্স নিয়ম

উৎস ভিডিও ও লক্ষ্য অডিও: সর্বোচ্চ 95 MB-এর ঠিক একটি MP4 বা MOV ভিডিও এবং সর্বোচ্চ 10 MB-এর একটি MP3, M4A, WAV, AAC বা OGG কণ্ঠ ট্র্যাক আপলোড করুন।

সর্বোচ্চ ফাইল

সমর্থিত ফাইল ধরন

video, audio

Duration token

duration verification প্রয়োজন হলে video এবং audio reference /api/v1/files থেকে durationToken বহন করবে।

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

ন্যূনতম request

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

create endpoint public task id ফেরত দেয়। task succeeded বা failed না হওয়া পর্যন্ত status endpoint poll করুন।

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

কিছু mode-এর জন্য Files API reference upload দরকার।

Volcengine Video Lip Sync API ইন্টিগ্রেশন