דילוג לתוכן

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 הוא עותק באחסון שלנו: נשמר לצמיתות (בתשלום לפי GB-חודש) או למשך 7 ימים ללא תשלום, בהתאם להגדרת החשבון או ל־?storage=.
אותו מבנה בכל מודלtype, url, content_type, width, height ו-duration, עבור תמונות, וידאו ואודיו כאחד. output הוא אובייקט התוצאה של המודל עצמו.
שדות הפלט
video
object {url, content_type, file_name, file_size}קובץ הווידאו שנוצר.

מודלים נוספים: סנכרון שפתיים ואווטארים

לסוכני AI: דף זה בפורמט Markdown נמצא בכתובת https://doitong.com/he/developers/models/live-portrait.md. כל המודלים והמדריכים: https://doitong.com/developers/llms.txt