رفتن به محتوا

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"

تا ⁨‎$۴٫۵۰⁩ برای هر اجرا بر اساس مصرف واقعی هزینه دریافت می‌شود و مابقی بازپرداخت می‌شود اجرای آن در این صفحه

دریافت کلید API
Kuaishou همگام‌سازی لب و آواتارها همگام‌سازی لب #expression#animation

تصویر پرتره را با حالت‌های چهره گرفته‌شده از ویدیوی محرک متحرک می‌کند و کنترل‌های دقیق چهره دارد

Kuaishou · ویدیو

اولین نتیجه شما اینجا قرار می‌گیرد

درخواست را در زیر بسازید و با کلید API خود اجرا کنید. خروجی‌ها در فضای ذخیره‌سازی ما کپی می‌شوند و برای همیشه یا به‌مدت ۷ روز رایگان نگه‌داری می‌شوند.

ساخت درخواست

کنترل‌ها از شِمای مدل تولید می‌شوند. با تغییر آن‌ها، کد و قیمت به‌روزرسانی می‌شوند.

•الزامی 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 قیمت → ⁨‎$۴٫۵۰⁩
# 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
−۳۰ – ۳۰
میزان بالا یا پایین‌بردن ابرو.
winkاختیاری
نوعnumber
پیش‌فرض0
۰ – ۲۵
میزان چشمک‌زدن.
pupil_xاختیاری
نوعnumber
پیش‌فرض0
−۴۵ – ۴۵
میزان حرکت افقی مردمک.
pupil_yاختیاری
نوعnumber
پیش‌فرض0
−۴۵ – ۴۵
میزان حرکت عمودی مردمک.
aaaاختیاری
نوعnumber
پیش‌فرض0
−۲۰۰ – ۲۰۰
میزان بازشدن دهان به شکل 'aaa'.
eeeاختیاری
نوعnumber
پیش‌فرض0
−۴۰ – ۴۰
میزان شکل‌دهی دهان به حالت 'eee'.
wooاختیاری
نوعnumber
پیش‌فرض0
−۱۰۰ – ۱۰۰
میزان شکل‌دهی دهان به حالت 'woo'.
smileاختیاری
نوعnumber
پیش‌فرض0
−۲ – ۲
میزان لبخند.
flag_lip_zeroاختیاری
نوعboolean
پیش‌فرضtrue
بسته‌شدن لب پیش از انیمیشن؛ فقط وقتی هر دو پرچم flag_eye_retargeting و flag_lip_retargeting روی False باشند اعمال می‌شود.
rotate_pitchاختیاری
نوعnumber
پیش‌فرض0
−۴۵ – ۴۵
میزان چرخش چهره حول محور pitch.
rotate_yawاختیاری
نوعnumber
پیش‌فرض0
−۴۵ – ۴۵
میزان چرخش چهره حول محور yaw.
rotate_rollاختیاری
نوعnumber
پیش‌فرض0
−۴۵ – ۴۵
میزان چرخش چهره حول محور 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 کپی‌ای در فضای ذخیره‌سازی ماست: برای همیشه (با هزینه به‌ازای هر GB-ماه) یا به‌مدت ۷ روز رایگان، بر اساس تنظیم حساب شما یا ?storage=.
ساختار یکسان در همه مدل‌هاtype، url، content_type، width، height و duration برای تصاویر، ویدیو و صدا یکسان هستند. output شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
video
object {url, content_type, file_name, file_size}فایل ویدیویی تولیدشده.

مدل‌های بیشتر: همگام‌سازی لب و آواتارها

برای عامل‌های هوش مصنوعی: این صفحه به‌صورت Markdown در دسترس است https://doitong.com/fa/developers/models/live-portrait.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt