رفتن به محتوا

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"

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

دریافت کلید API
Kuaishou ویرایش تصویر #expression#animation

حالت چهره و ژست سر یک پرتره را با لغزنده‌ها ویرایش می‌کند و تصویر ثابت خروجی می‌دهد

Kuaishou · تصویر

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

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

ساخت درخواست

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

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

مدل‌های بیشتر: ویرایش تصویر

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