Przejdź do treści

Live Portrait

Integracja

Identyfikator modelu 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"

Do 4,50 $ za uruchomienie opłata jest naliczana za rzeczywiste wykorzystanie, a reszta jest zwracana Uruchom na tej stronie

Uzyskaj klucz API
Kuaishou Synchronizacja ruchu ust i awatary Synchronizacja ruchu ust #expression#animation

Animuje portret na podstawie wyrazu twarzy z wideo sterującego, z precyzyjną kontrolą twarzy

Kuaishou · Wideo

Tutaj pojawi się pierwszy wynik

Zbuduj poniżej żądanie i uruchom je za pomocą klucza API. Wyniki są kopiowane do naszej przestrzeni dyskowej i przechowywane bezterminowo lub 7 dni bezpłatnie.

Zbuduj żądanie

Elementy sterujące są generowane ze schematu modelu. Kod i cena aktualizują się podczas ich zmiany.

•wymagane video_url
Upuść plik lub

URL wideo używanego do sterowania synchronizacją ust.

•wymagane image_url
Upuść plik lub

URL obrazu do animacji.

Zaawansowane 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
domyślnie 0
domyślnie 0

Stopień unoszenia lub opuszczania brwi.

domyślnie 0

Stopień mrugania jednym okiem.

domyślnie 0

Zakres poziomego ruchu źrenic.

domyślnie 0

Zakres pionowego ruchu źrenic.

domyślnie 0

Stopień otwarcia ust w kształcie 'aaa'.

domyślnie 0

Stopień ułożenia ust w pozycji 'eee'.

domyślnie 0

Stopień ułożenia ust w pozycji 'woo'.

domyślnie 0

Stopień uśmiechu.

domyślnie 0

Zakres obrotu twarzy wokół osi pitch.

domyślnie 0

Zakres obrotu twarzy wokół osi yaw.

domyślnie 0

Zakres obrotu twarzy wokół osi roll.

domyślnie 512

Wymiary wynikowego obrazu.

domyślnie 2.3

Mnożnik skali stosowany do wycinka twarzy.

domyślnie 0

Współczynnik sterujący poziomym przesunięciem wycinka twarzy.

domyślnie -0.125

Współczynnik pionowego położenia wycinka twarzy: znak określa kierunek — wartości dodatnie przesuwają w górę, a ujemne w dół.

domyślnie 32

Rozmiar partii modelu, z kompromisem między szybkością a pamięcią: zwiększenie wartości zużywa więcej pamięci w zamian za szybsze wykonanie.

POST /run/live-portrait?wait=20 wycena → 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"

Uruchom to żądanie

Klucz pozostaje w tej przeglądarce: jest wysyłany tylko do Doitong API i zapisywany (localStorage) tylko po zaznaczeniu opcji Zapamiętaj. Uzyskaj klucz API

Informacje o Live Portrait

Przenosi ruch twarzy z wideo sterującego na nieruchomy portret, tworząc wideo. Oprócz `video_url` i `image_url` oferuje liczbowe elementy sterujące mruganiem, brwiami, mrugnięciem jednym okiem, źrenicami, kształtami ust (aaa, eee, woo), uśmiechem i obrotem głowy w osiach pitch, yaw i roll. Dostępne są opcje kadrowania i nakładania, takie jak `flag_do_crop` i `flag_pasteback`, a `dsize` ustawia rozmiar wyjścia (domyślnie 512).

Parametry

Wyślij nazwę kanoniczną albo natywną, nie obie. Nazwy kanoniczne

NazwaTyp DomyślneDozwolone Opis
video_urlwymagane video
Typurl · video
URL wideo używanego do sterowania synchronizacją ust.
image_urlwymagane image
Typurl · image
URL obrazu do animacji.
eyebrowopcjonalne
Typnumber
Domyślne0
-30 – 30
Stopień unoszenia lub opuszczania brwi.
winkopcjonalne
Typnumber
Domyślne0
0 – 25
Stopień mrugania jednym okiem.
pupil_xopcjonalne
Typnumber
Domyślne0
-45 – 45
Zakres poziomego ruchu źrenic.
pupil_yopcjonalne
Typnumber
Domyślne0
-45 – 45
Zakres pionowego ruchu źrenic.
aaaopcjonalne
Typnumber
Domyślne0
-200 – 200
Stopień otwarcia ust w kształcie 'aaa'.
eeeopcjonalne
Typnumber
Domyślne0
-40 – 40
Stopień ułożenia ust w pozycji 'eee'.
wooopcjonalne
Typnumber
Domyślne0
-100 – 100
Stopień ułożenia ust w pozycji 'woo'.
smileopcjonalne
Typnumber
Domyślne0
-2 – 2
Stopień uśmiechu.
flag_lip_zeroopcjonalne
Typboolean
Domyślnetrue
Zamykanie ust przed animacją, dostępne tylko wtedy, gdy zarówno flag_eye_retargeting, jak i flag_lip_retargeting mają wartość False.
rotate_pitchopcjonalne
Typnumber
Domyślne0
-45 – 45
Zakres obrotu twarzy wokół osi pitch.
rotate_yawopcjonalne
Typnumber
Domyślne0
-45 – 45
Zakres obrotu twarzy wokół osi yaw.
rotate_rollopcjonalne
Typnumber
Domyślne0
-45 – 45
Zakres obrotu twarzy wokół osi roll.
flag_eye_retargetingopcjonalne
Typboolean
Domyślnefalse
Przełącznik retargetingu oczu.
flag_lip_retargetingopcjonalne
Typboolean
Domyślnefalse
Przełącznik retargetingu ust.
flag_stitchingopcjonalne
Typboolean
Domyślnetrue
Przełącznik zszywania; zaleca się jego włączenie.
flag_relativeopcjonalne
Typboolean
Domyślnetrue
Przełącznik ruchu względnego.
flag_pastebackopcjonalne
Typboolean
Domyślnetrue
Opcja wklejania z powrotem/łączenia, umieszczająca animowany wycinek twarzy w oryginalnym obrazie i odwzorowująca go poza współrzędne wycinka twarzy.
flag_do_cropopcjonalne
Typboolean
Domyślnetrue
Określa, czy portret źródłowy jest przycinany do przestrzeni współrzędnych wycinka twarzy.
flag_do_rotopcjonalne
Typboolean
Domyślnetrue
Określa, czy obrót jest wykonywany, gdy flag_do_crop ma wartość true.
dsizeopcjonalne
Typinteger
Domyślne512
Wymiary wynikowego obrazu.
scaleopcjonalne
Typnumber
Domyślne2.3
Mnożnik skali stosowany do wycinka twarzy.
vx_ratioopcjonalne
Typnumber
Domyślne0
Współczynnik sterujący poziomym przesunięciem wycinka twarzy.
vy_ratioopcjonalne
Typnumber
Domyślne-0.125
Współczynnik pionowego położenia wycinka twarzy: znak określa kierunek — wartości dodatnie przesuwają w górę, a ujemne w dół.
batch_sizeopcjonalne
Typinteger
Domyślne32
Rozmiar partii modelu, z kompromisem między szybkością a pamięcią: zwiększenie wartości zużywa więcej pamięci w zamian za szybsze wykonanie.
enable_safety_checkeropcjonalne
Typboolean
Domyślnefalse
Określa, czy kontrola bezpieczeństwa jest włączona. Gdy jest aktywna, kontroler przetwarza obraz wejściowy, aby sprawdzić, czy zawiera twarz, przed przetworzeniem przez model.
wymagane Nazwa kanoniczna, również akceptowana

Parametry plików przyjmują publiczny URL https://, identyfikator URI data: do 10 MB albo file_url przesłanego pliku. Pliki

Wynik

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"
  }
}
Twoje pliki, Twój wybórKażdy outputs[].url to kopia w naszej przestrzeni dyskowej: przechowywana bezterminowo (opłata za GB-miesiąc) lub 7 dni bezpłatnie, zgodnie z ustawieniem konta lub ?storage=.
Taki sam format w każdym modelutype, url, content_type, width, height i duration — tak samo dla obrazów, filmów i dźwięku. output to własny obiekt wyniku modelu.
Pola wyniku
video
object {url, content_type, file_name, file_size}Plik wideo utworzony podczas generowania.

Więcej modeli: Synchronizacja ruchu ust i awatary

Dla agentów AI: ta strona w formacie Markdown jest dostępna pod adresem https://doitong.com/pl/developers/models/live-portrait.md. Wszystkie modele i przewodniki: https://doitong.com/developers/llms.txt