استخدم Volcengine Video Lip Sync عبر Rivya Public API v1 مع معرف النموذج volcengine-video-lip-sync، والمدخلات المدعومة، والمعلمات، وقواعد Files API، والأرصدة، وأمثلة الاستجابة.

متاح عبر APIالجاهزيةفيديو

معرف نموذج API

volcengine-video-lip-sync

المدخلات

file

Files API

مطلوب لأوضاع المراجع

الأرصدة الأساسية

per_input_second · default=8 · ⌈total⌉

القدرة

فيديو

الفوترة

METERED

حد prompt

لا يوجد حد prompt موثق

عقد الطلب

أرسل معرف النموذج في المستوى الأعلى. توضع عناصر التحكم الخاصة بالنموذج داخل params.

المفتاح	النوع	مطلوب	الافتراضي	الوصف
model	string	نعم	volcengine-video-lip-sync	استخدم معرف نموذج API وهو volcengine-video-lip-sync.
prompt	string	لا	-	نص prompt للنماذج التي تدعم إدخال النص.
params	object	نعم	-	كائن معلمات خاص بالنموذج. استخدم الصفوف أدناه لمعرفة المفاتيح المسموح بها.
client_request_id	string	لا	-	معرف اختياري من جهة العميل لتتبع الطلبات في نظامك.

معلمات النموذج

المفتاح	النوع	مطلوب	الافتراضي	النطاق	الخيارات	الوصف
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

Duration token

ينبغي أن تحمل مراجع الفيديو والصوت durationToken من /api/v1/files عندما يكون التحقق من المدة مطلوبا.

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

استجابة الإنشاء

تعيد نقطة نهاية الإنشاء معرف مهمة عامًا. استعلم عن نقطة نهاية الحالة حتى تنجح المهمة أو تفشل.

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