Мазмұнға өту

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-ге жіберіледі және Remember параметрін белгілеcеңіз ғана 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
Анимацияланған бет қиындысын бастапқы кескінге орналастыратын paste-back/жапсыру параметрі; оны 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
Бет қиындысына қолданылатын масштабтау көбейткіші.
vx_ratioміндетті емес
Түріnumber
Әдепкі0
Бет қиындысының көлденең ығысуын басқаратын арақатынас.
vy_ratioміндетті емес
Түріnumber
Әдепкі-0.125
Бет қиындысының тік орналасу арақатынасы: таңба бағытты анықтайды, оң мән жоғары, теріс мән төмен бағыттайды.
batch_sizeміндетті емес
Түріinteger
Әдепкі32
Модель пакетінің өлшемі; жылдамдық пен жад арасындағы айырбас: оны арттыру жадты көбірек пайдаланып, орындауды жылдамдатады.
enable_safety_checkerміндетті емес
Түріboolean
Әдепкіfalse
Қауіпсіздік тексеруінің қосылғанын басқарады. Белсенді кезде тексергіш модель өңдеуіне дейін кіріс кескінінде бет бар-жоғын тексереді.
міндетті Канондық атау, бұл да қабылданады

Файл параметрлері жалпыға қолжетімді https:// URL мекенжайын, 10 MB-қа дейінгі data: URI мекенжайын немесе жүктеп салынған файлдың 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= арқылы 7 күн тегін сақталады.
Әр модельдегі пішім бірдейtype, url, content_type, width, height және duration — кескіндерге, бейнеге және аудиоға ортақ. output — модельдің өз нәтижелер нысаны.
Шығыс өрістері
video
object {url, content_type, file_name, file_size}Генерация нәтижесінде алынған бейне файлы.

Қосымша модельдер: Ерін синхрондауы және аватарлар

AI агенттеріне: бұл беттің Markdown нұсқасы мына жерде: https://doitong.com/kk/developers/models/live-portrait.md. Барлық модельдер мен нұсқаулықтар: https://doitong.com/developers/llms.txt