تخطّي إلى المحتوى

Live Portrait

التكامل

معرّف النموذج live-portrait
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/live-portrait?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "image": "https://content.doitong.com/images/showcase/v3/avatar/talking_avatar.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

حتى ⁨‏4.50 $⁩ لكل تشغيل تُحتسب التكلفة حسب الاستخدام الفعلي، ويُسترد الباقي تشغيله في هذه الصفحة

الحصول على مفتاح API
Kuaishou مزامنة الشفاه والصور الرمزية مزامنة الشفاه #expression#animation

يحرّك صورة شخصية بتعبيرات مأخوذة من فيديو محرك، مع تحكم دقيق في الوجه

Kuaishou · فيديو

ستظهر نتيجتك الأولى هنا

أنشئ طلبًا أدناه وشغّله باستخدام مفتاح API الخاص بك. تُنسخ المخرجات إلى تخزيننا، وتُحفظ إلى الأبد أو لمدة 7 أيام مجانًا.

إنشاء طلب

تُنشأ عناصر التحكم من مخطط النموذج. يتحدّث الرمز والسعر عند تغييرها.

•مطلوب video_url
أفلت ملفًا، أو

عنوان URL لفيديو يُستخدم لقيادة مزامنة الشفاه.

•مطلوب image_url
أفلت ملفًا، أو

عنوان URL لصورة للتحريك.

متقدم blink · eyebrow · wink · pupil_x · pupil_y · aaa · eee · woo · smile · rotate_pitch · rotate_yaw · rotate_roll · dsize · scale · vx_ratio · vy_ratio · batch_size · flag_lip_zero · flag_eye_retargeting · flag_lip_retargeting · flag_stitching · flag_relative · flag_pasteback · flag_do_crop · flag_do_rot · enable_safety_checker
الافتراضي 0
الافتراضي 0

درجة رفع الحاجبين أو خفضهما.

الافتراضي 0

درجة الغمز.

الافتراضي 0

مقدار حركة البؤبؤ أفقيًا.

الافتراضي 0

مقدار حركة البؤبؤ رأسيًا.

الافتراضي 0

درجة فتح الفم على شكل 'aaa'.

الافتراضي 0

درجة تشكيل الفم على وضعية 'eee'.

الافتراضي 0

درجة تشكيل الفم على وضعية 'woo'.

الافتراضي 0

درجة الابتسام.

الافتراضي 0

مقدار دوران الوجه على محور pitch.

الافتراضي 0

مقدار دوران الوجه على محور yaw.

الافتراضي 0

مقدار دوران الوجه على محور roll.

الافتراضي 512

أبعاد الصورة الناتجة.

الافتراضي 2.3

مضاعف التحجيم المطبّق على قصاصة الوجه.

الافتراضي 0

نسبة تتحكم في الإزاحة الأفقية لقصاصة الوجه.

الافتراضي -0.125

نسبة الموضع الرأسي لقصاصة الوجه: تحدد الإشارة الاتجاه، فالقيم الموجبة إلى الأعلى والسالبة إلى الأسفل.

الافتراضي 32

حجم دفعة النموذج، مع موازنة بين السرعة والذاكرة: تؤدي زيادته إلى استخدام ذاكرة أكبر مقابل تنفيذ أسرع.

POST /run/live-portrait?wait=20 عرض السعر → ⁨‏4.50 $⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/live-portrait?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "image": "https://content.doitong.com/images/showcase/v3/avatar/talking_avatar.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

تشغيل هذا الطلب

يبقى مفتاحك في هذا المتصفح: لا يُرسل إلا إلى Doitong API ويُحفظ في localStorage فقط إذا فعّلت خيار التذكّر. الحصول على مفتاح API

حول Live Portrait

ينقل حركة الوجه من فيديو محرك إلى صورة شخصية ثابتة، منتجًا فيديو. إلى جانب `video_url` و`image_url`، يوفر عناصر تحكم رقمية للرمش والحاجب والغمز والبؤبؤ وأشكال الفم (aaa وeee وwoo) والابتسامة ودوران الرأس في pitch وyaw وroll. تتوفر خيارات الاقتصاص واللصق مثل `flag_do_crop` و`flag_pasteback`، ويحدد `dsize` حجم الناتج (الافتراضي 512).

المعاملات

أرسل الاسم الأساسي أو الاسم الأصلي، وليس كليهما. الأسماء الأساسية

الاسمالنوع الافتراضيمسموح الوصف
video_urlمطلوب video
النوعurl · video
عنوان URL لفيديو يُستخدم لقيادة مزامنة الشفاه.
image_urlمطلوب image
النوعurl · image
عنوان URL لصورة للتحريك.
eyebrowاختياري
النوعnumber
الافتراضي0
-30 – 30
درجة رفع الحاجبين أو خفضهما.
winkاختياري
النوعnumber
الافتراضي0
0 – 25
درجة الغمز.
pupil_xاختياري
النوعnumber
الافتراضي0
-45 – 45
مقدار حركة البؤبؤ أفقيًا.
pupil_yاختياري
النوعnumber
الافتراضي0
-45 – 45
مقدار حركة البؤبؤ رأسيًا.
aaaاختياري
النوعnumber
الافتراضي0
-200 – 200
درجة فتح الفم على شكل 'aaa'.
eeeاختياري
النوعnumber
الافتراضي0
-40 – 40
درجة تشكيل الفم على وضعية 'eee'.
wooاختياري
النوعnumber
الافتراضي0
-100 – 100
درجة تشكيل الفم على وضعية 'woo'.
smileاختياري
النوعnumber
الافتراضي0
-2 – 2
درجة الابتسام.
flag_lip_zeroاختياري
النوعboolean
الافتراضيtrue
إغلاق الشفاه قبل التحريك، ويُطبّق فقط عند ضبط كل من flag_eye_retargeting وflag_lip_retargeting على False.
rotate_pitchاختياري
النوعnumber
الافتراضي0
-45 – 45
مقدار دوران الوجه على محور pitch.
rotate_yawاختياري
النوعnumber
الافتراضي0
-45 – 45
مقدار دوران الوجه على محور yaw.
rotate_rollاختياري
النوعnumber
الافتراضي0
-45 – 45
مقدار دوران الوجه على محور roll.
flag_eye_retargetingاختياري
النوعboolean
الافتراضيfalse
مفتاح إعادة استهداف العينين.
flag_lip_retargetingاختياري
النوعboolean
الافتراضيfalse
مفتاح إعادة استهداف الشفاه.
flag_stitchingاختياري
النوعboolean
الافتراضيtrue
مفتاح الخياطة؛ يوصى بتفعيله.
flag_relativeاختياري
النوعboolean
الافتراضيtrue
مفتاح الحركة النسبية.
flag_pastebackاختياري
النوعboolean
الافتراضيtrue
خيار اللصق/الخياطة الذي يضع قصاصة الوجه المتحركة داخل الصورة الأصلية، مع تحويلها من إحداثيات قصاصة الوجه.
flag_do_cropاختياري
النوعboolean
الافتراضيtrue
يتحكم فيما إذا كانت صورة المصدر تُقص إلى مساحة إحداثيات قصاصة الوجه.
flag_do_rotاختياري
النوعboolean
الافتراضيtrue
يتحكم فيما إذا كان الدوران يُجرى عند كون flag_do_crop هو true.
dsizeاختياري
النوعinteger
الافتراضي512
أبعاد الصورة الناتجة.
scaleاختياري
النوعnumber
الافتراضي2.3
مضاعف التحجيم المطبّق على قصاصة الوجه.
vx_ratioاختياري
النوعnumber
الافتراضي0
نسبة تتحكم في الإزاحة الأفقية لقصاصة الوجه.
vy_ratioاختياري
النوعnumber
الافتراضي-0.125
نسبة الموضع الرأسي لقصاصة الوجه: تحدد الإشارة الاتجاه، فالقيم الموجبة إلى الأعلى والسالبة إلى الأسفل.
batch_sizeاختياري
النوعinteger
الافتراضي32
حجم دفعة النموذج، مع موازنة بين السرعة والذاكرة: تؤدي زيادته إلى استخدام ذاكرة أكبر مقابل تنفيذ أسرع.
enable_safety_checkerاختياري
النوعboolean
الافتراضيfalse
يتحكم فيما إذا كان فحص السلامة مفعّلًا. عند تفعيله، يعالج الفاحص صورة المدخل للتحقق من احتوائها على وجه قبل معالجة النموذج.
مطلوب الاسم الأساسي، مقبول أيضًا

تقبل معاملات الملفات عنوان URL عامًا يبدأ بـ https://، أو URI من نوع data: يصل حجمه إلى 10 MB، أو file_url لملف تم تحميله. الملفات

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "live-portrait",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 4500,
    "usd": "4.50",
    "charged": 4500,
    "refunded": 0
  },
  "input": {
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "image_url": "https://content.doitong.com/images/showcase/v3/avatar/talking_avatar.jpg"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ملفاتك، خيارككل outputs[].url هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?storage=.
البنية نفسها في كل نموذجtype وurl وcontent_type وwidth وheight وduration للصور والفيديو والصوت على حد سواء. output هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
video
object {url, content_type, file_name, file_size}ملف الفيديو الناتج عن التوليد.

مزيد من النماذج: مزامنة الشفاه والصور الرمزية

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/live-portrait.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt