שפּרינגען צו אינהאַלט

Live Portrait

אינטעגרירן

מאָדעל־id live-portrait
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/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.ru/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

סקייל־מולטיפּליקאַטאָר געווענדט צו face crop.

סטאַנדאַרט 0

פֿאַרהעלטעניש וואָס קאָנטראָלירט דעם האָריזאָנטאַלן אָפֿסעט פֿון face crop.

סטאַנדאַרט -0.125

ווערטיקאַלער פּאָזיציע־ראַטע פֿון face crop: דער צייכן באַשטימט די ריכטונג, אַרויף פֿאַר פּאָזיטיווע ווערטן און אַראָפּ פֿאַר נעגאַטיווע.

סטאַנדאַרט 32

מאָדעל־batch־גרייס, מיט אַ גיכקייט–זכּרון־קאָמפּראָמיס: אַ גרעסערע גרייס ניצט מער זכּרון פֿאַר שנעלער אויספֿיר.

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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

לויפֿן דעם ריקוועסט

אײַער 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
באַשטעטיקונג פֿאַר eye retargeting.
flag_lip_retargetingאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
באַשטעטיקונג פֿאַר lip retargeting.
flag_stitchingאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
באַשטעטיקונג פֿאַר stitching; עס איז רעקאָמענדירט זי צו אַקטיוויזירן.
flag_relativeאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
באַשטעטיקונג פֿאַר רעלאַטיווער באַוועגונג.
flag_pastebackאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
Paste-back/stitching־אָפּציע וואָס לייגט דעם אַנימירטן פּנים־crop צוריק אין אָריגינעלן בילד און מאַפּט אים אַרויס פֿון face-crop־קאָרדינאַטן.
flag_do_cropאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
קאָנטראָלירט צי דער מקור־פּאָרטרעט ווערט געקראַפּט אין face-crop־קאָרדינאַטן־רום.
flag_do_rotאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
קאָנטראָלירט צי ראָוטאַציע ווערט דורכגעפֿירט ווען flag_do_crop איז true.
dsizeאָפּציאָנעל
טיפּinteger
סטאַנדאַרט512
דימענסיעס פֿון רעזולטירנדיקן בילד.
scaleאָפּציאָנעל
טיפּnumber
סטאַנדאַרט2.3
סקייל־מולטיפּליקאַטאָר געווענדט צו face crop.
vx_ratioאָפּציאָנעל
טיפּnumber
סטאַנדאַרט0
פֿאַרהעלטעניש וואָס קאָנטראָלירט דעם האָריזאָנטאַלן אָפֿסעט פֿון face crop.
vy_ratioאָפּציאָנעל
טיפּnumber
סטאַנדאַרט-0.125
ווערטיקאַלער פּאָזיציע־ראַטע פֿון face crop: דער צייכן באַשטימט די ריכטונג, אַרויף פֿאַר פּאָזיטיווע ווערטן און אַראָפּ פֿאַר נעגאַטיווע.
batch_sizeאָפּציאָנעל
טיפּinteger
סטאַנדאַרט32
מאָדעל־batch־גרייס, מיט אַ גיכקייט–זכּרון־קאָמפּראָמיס: אַ גרעסערע גרייס ניצט מער זכּרון פֿאַר שנעלער אויספֿיר.
enable_safety_checkerאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
קאָנטראָלירט צי זיכערהייט־קאָנטראָל איז אַקטיוו. ווען אַקטיוו, פּראַסעסט דער קאָנטראָלער דאָס אַרײַנגעבונג־בילד צו באַשטעטיקן אַז עס אַנטהאַלט אַ פּנים איידער מאָדעל־פּראַסעסירונג.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

טעקע־פּאַראַמעטערס נעמען אַן עפֿנטלעכע https:// URL, אַ data: URI ביז 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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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/yi/developers/models/live-portrait.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt