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

Live Portrait · Image

التكامل

معرّف النموذج live-portrait/image
# 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/image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.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"

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

الحصول على مفتاح API
Kuaishou تحرير الصور #expression#animation

يحرر تعبيرات وجه شخصية واحدة ووضعية رأسها باستخدام أشرطة التمرير، ويخرج صورة ثابتة

Kuaishou · صورة

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

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

إنشاء طلب

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

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

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

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

التنسيق المستخدم للمخرج.

الافتراضي 0
الافتراضي 0

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

الافتراضي 0

درجة الغمز.

الافتراضي 0

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

الافتراضي 0

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

الافتراضي 0

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

الافتراضي 0

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

الافتراضي 0

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

الافتراضي 0

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

الافتراضي 0

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

الافتراضي 0

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

الافتراضي 0

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

الافتراضي 512

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

الافتراضي 2.3

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

الافتراضي 0

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

الافتراضي -0.125

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

POST /run/live-portrait/image?wait=20 عرض السعر → ⁨‏1.125 $⁩
# 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/image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.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 · Image

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

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
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
درجة الابتسام.
rotate_pitchاختياري
النوعnumber
الافتراضي0
-45 – 45
مقدار دوران الوجه على محور pitch.
rotate_yawاختياري
النوعnumber
الافتراضي0
-45 – 45
مقدار دوران الوجه على محور yaw.
rotate_rollاختياري
النوعnumber
الافتراضي0
-45 – 45
مقدار دوران الوجه على محور roll.
flag_pastebackاختياري
النوعboolean
الافتراضيtrue
خيار اللصق/الخياطة الذي يضع قصاصة الوجه المتحركة داخل الصورة الأصلية، مع تحويلها من إحداثيات قصاصة الوجه.
flag_do_cropاختياري
النوعboolean
الافتراضيtrue
يتحكم فيما إذا كانت صورة المصدر تُقص إلى مساحة إحداثيات قصاصة الوجه.
flag_do_rotاختياري
النوعboolean
الافتراضيtrue
يتحكم فيما إذا كان الدوران يُجرى عند كون flag_do_crop هو true.
flag_lip_zeroاختياري
النوعboolean
الافتراضيtrue
إغلاق الشفاه قبل التحريك، ويُطبّق فقط عند ضبط كل من flag_eye_retargeting وflag_lip_retargeting على False.
dsizeاختياري
النوعinteger
الافتراضي512
أبعاد الصورة الناتجة.
scaleاختياري
النوعnumber
الافتراضي2.3
مضاعف التحجيم المطبّق على قصاصة الوجه.
vx_ratioاختياري
النوعnumber
الافتراضي0
نسبة تتحكم في الإزاحة الأفقية لقصاصة الوجه.
vy_ratioاختياري
النوعnumber
الافتراضي-0.125
نسبة الموضع الرأسي لقصاصة الوجه: تحدد الإشارة الاتجاه، فالقيم الموجبة إلى الأعلى والسالبة إلى الأسفل.
enable_safety_checkerاختياري
النوعboolean
الافتراضيfalse
يتحكم فيما إذا كان فحص السلامة مفعّلًا. عند تفعيله، يعالج الفاحص صورة المدخل للتحقق من احتوائها على وجه قبل معالجة النموذج.
output_formatاختياري
النوعenum
الافتراضيjpeg
jpegpng
التنسيق المستخدم للمخرج.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "live-portrait/image",
  "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": 1125,
    "usd": "1.125",
    "charged": 1125,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "image": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768
    }
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "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 هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
image
object {url, content_type, file_name, file_size, width, height}ملف صورة ناتج عن التوليد.

مزيد من النماذج: تحرير الصور

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