Volcengine Video Lip Sync کو Rivya Public API v1 کے ذریعے model id volcengine-video-lip-sync، supported inputs، parameters، Files API rules، credits اور response examples کے ساتھ استعمال کریں۔

API کے ذریعے availableReadinessویڈیو

API model id

volcengine-video-lip-sync

Inputs

file

Files API

Reference modes کے لیے required

Base credits

per_input_second · default=8 · ⌈total⌉

Capability

ویڈیو

Billing

METERED

Prompt limit

کوئی documented prompt limit نہیں

Request contract

model id کو top level پر بھیجیں۔ Model-specific controls params میں رہتے ہیں۔

Key	Type	Required	Default	Description
model	string	Yes	volcengine-video-lip-sync	volcengine-video-lip-sync API model id استعمال کریں۔
prompt	string	No	-	Text input support کرنے والے models کے لیے prompt text۔
params	object	Yes	-	Model-specific parameter object۔ allowed keys کے لیے نیچے والی rows استعمال کریں۔
client_request_id	string	No	-	آپ کے system میں requests trace کرنے کے لیے optional client-side id۔

Model parameters

Key	Type	Required	Default	Range	Options	Description
mode	select	Yes	lite	-	lite, basic	Lite سامنے کی طرف رخ کیے ایک شخص کی فوٹیج کے لیے موزوں ہے؛ Basic ایک شخص کے زیادہ پیچیدہ مناظر کی معاونت کرتا ہے۔
separate_vocal	select	No	false	-	false, true	ہدف آڈیو میں پس منظر کی آواز ہو جسے دبانا ہو تو آواز کی علیحدگی فعال کریں۔
open_scenedet	select	No	false	-	false, true	منظر تقسیم اور مقرر کی شناخت کے لیے صرف Basic موڈ میں دستیاب ہے۔
align_audio	select	No	true	-	true, false	صرف Lite موڈ میں دستیاب ہے۔ آڈیو ماخذ فوٹیج سے طویل ہو تو ویڈیو کو بار بار چلائیں۔
align_audio_reverse	select	No	false	-	false, true	صرف Lite موڈ میں دستیاب ہے اور آڈیو مطابقت کا چالو ہونا ضروری ہے۔
templ_start_seconds	number	No	0	min 0	-	صرف Lite موڈ میں دستیاب ہے۔ ماخذ ویڈیو میں صفر یا اس سے زیادہ آغاز کا وقت منتخب کریں۔

Upload policy

Reference files پہلے upload کریں، پھر returned URL اور duration token کو params.referenceMediaItems کے اندر رکھیں۔

Reference rule

ماخذ ویڈیو اور ہدف آڈیو: 95 MB تک کی بالکل ایک MP4 یا MOV ویڈیو اور 10 MB تک کا ایک MP3، M4A، WAV، AAC یا OGG آواز کا ٹریک اپ لوڈ کریں۔

Max files

Accepted file kinds

video, audio

Duration token

duration verification required ہو تو video اور audio references کو /api/v1/files سے durationToken ساتھ رکھنا چاہیے۔

kind	Max size	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

Minimal 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
  }
}

Reference-file 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,
    "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
}

Common errors

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

کچھ modes کو Files API reference uploads درکار ہوتے ہیں۔

Volcengine Video Lip Sync API Integration