Přejít na obsah

Live Portrait

Integrace

ID 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"

Až 4,50 $ za spuštění účtuje se skutečné využití, zbytek se refunduje Spustit na této stránce

Získat API klíč
Kuaishou Synchronizace rtů a avataři Synchronizace rtů #expression#animation

Animuje portrétní obrázek výrazy převzatými z řídicího videa s podrobným ovládáním obličeje

Kuaishou · Video

Zde se zobrazí váš první výsledek

Níže sestavte požadavek a spusťte ho pomocí svého API klíče. Výstupy se kopírují do našeho úložiště a uchovávají se navždy nebo 7 dne zdarma.

Sestavit požadavek

Ovládací prvky se generují ze schématu modelu. Kód a cena se aktualizují podle provedených změn.

•povinné video_url
Přetáhněte soubor nebo

URL videa použitého k řízení synchronizace rtů.

•povinné image_url
Přetáhněte soubor nebo

URL obrázku pro animaci.

Pokročilé 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
výchozí 0
výchozí 0

Míra zvednutí nebo spuštění obočí.

výchozí 0

Míra mrknutí jedním okem.

výchozí 0

Velikost horizontálního pohybu zorniček.

výchozí 0

Velikost vertikálního pohybu zorniček.

výchozí 0

Míra otevření úst do tvaru 'aaa'.

výchozí 0

Míra tvarování úst do polohy 'eee'.

výchozí 0

Míra tvarování úst do polohy 'woo'.

výchozí 0

Míra úsměvu.

výchozí 0

Velikost rotace obličeje kolem osy pitch.

výchozí 0

Velikost rotace obličeje kolem osy yaw.

výchozí 0

Velikost rotace obličeje kolem osy roll.

výchozí 512

Rozměry výsledného obrázku.

výchozí 2.3

Násobitel měřítka použitý na výřez obličeje.

výchozí 0

Poměr určující horizontální posun výřezu obličeje.

výchozí -0.125

Poměr vertikálního umístění výřezu obličeje: znaménko určuje směr, kladné hodnoty nahoru a záporné dolů.

výchozí 32

Velikost dávky modelu s kompromisem mezi rychlostí a pamětí: zvýšení hodnoty využije více paměti výměnou za rychlejší provedení.

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

Spustit tento požadavek

Váš klíč zůstává v tomto prohlížeči: odesílá se pouze do Doitong API a uloží se do localStorage jen tehdy, když zaškrtnete možnost Zapamatovat. Získat klíč API

O modelu Live Portrait

Přenese pohyb obličeje z řídicího videa na statický portrét a vytvoří video. Kromě `video_url` a `image_url` nabízí číselné ovládací prvky pro mrkání, obočí, mrknutí jedním okem, zorničky, tvary úst (aaa, eee, woo), úsměv a rotaci hlavy v osách pitch, yaw a roll. K dispozici jsou volby ořezu a vkládání, například `flag_do_crop` a `flag_pasteback`, a `dsize` nastavuje výstupní velikost (výchozí 512).

Parametry

Odešlete buď kanonický název, nebo nativní název, ne oba. Kanonické názvy

NázevTyp VýchozíPovolené Popis
video_urlpovinné video
Typurl · video
URL videa použitého k řízení synchronizace rtů.
image_urlpovinné image
Typurl · image
URL obrázku pro animaci.
eyebrowvolitelné
Typnumber
Výchozí0
-30 – 30
Míra zvednutí nebo spuštění obočí.
winkvolitelné
Typnumber
Výchozí0
0 – 25
Míra mrknutí jedním okem.
pupil_xvolitelné
Typnumber
Výchozí0
-45 – 45
Velikost horizontálního pohybu zorniček.
pupil_yvolitelné
Typnumber
Výchozí0
-45 – 45
Velikost vertikálního pohybu zorniček.
aaavolitelné
Typnumber
Výchozí0
-200 – 200
Míra otevření úst do tvaru 'aaa'.
eeevolitelné
Typnumber
Výchozí0
-40 – 40
Míra tvarování úst do polohy 'eee'.
woovolitelné
Typnumber
Výchozí0
-100 – 100
Míra tvarování úst do polohy 'woo'.
smilevolitelné
Typnumber
Výchozí0
-2 – 2
Míra úsměvu.
flag_lip_zerovolitelné
Typboolean
Výchozítrue
Uzavření rtů před animací, použitelné pouze při nastavení flag_eye_retargeting i flag_lip_retargeting na False.
rotate_pitchvolitelné
Typnumber
Výchozí0
-45 – 45
Velikost rotace obličeje kolem osy pitch.
rotate_yawvolitelné
Typnumber
Výchozí0
-45 – 45
Velikost rotace obličeje kolem osy yaw.
rotate_rollvolitelné
Typnumber
Výchozí0
-45 – 45
Velikost rotace obličeje kolem osy roll.
flag_eye_retargetingvolitelné
Typboolean
Výchozífalse
Přepínač retargetingu očí.
flag_lip_retargetingvolitelné
Typboolean
Výchozífalse
Přepínač retargetingu rtů.
flag_stitchingvolitelné
Typboolean
Výchozítrue
Přepínač sešití; jeho aktivaci doporučujeme.
flag_relativevolitelné
Typboolean
Výchozítrue
Přepínač relativního pohybu.
flag_pastebackvolitelné
Typboolean
Výchozítrue
Volba zpětného vložení/sešití, která umístí animovaný výřez obličeje do původního obrázku a převede jej ze souřadnic výřezu obličeje.
flag_do_cropvolitelné
Typboolean
Výchozítrue
Určuje, zda se zdrojový portrét ořízne do souřadnicového prostoru výřezu obličeje.
flag_do_rotvolitelné
Typboolean
Výchozítrue
Určuje, zda se při hodnotě flag_do_crop true provede rotace.
dsizevolitelné
Typinteger
Výchozí512
Rozměry výsledného obrázku.
scalevolitelné
Typnumber
Výchozí2.3
Násobitel měřítka použitý na výřez obličeje.
vx_ratiovolitelné
Typnumber
Výchozí0
Poměr určující horizontální posun výřezu obličeje.
vy_ratiovolitelné
Typnumber
Výchozí-0.125
Poměr vertikálního umístění výřezu obličeje: znaménko určuje směr, kladné hodnoty nahoru a záporné dolů.
batch_sizevolitelné
Typinteger
Výchozí32
Velikost dávky modelu s kompromisem mezi rychlostí a pamětí: zvýšení hodnoty využije více paměti výměnou za rychlejší provedení.
enable_safety_checkervolitelné
Typboolean
Výchozífalse
Určuje, zda je povolena kontrola bezpečnosti. Je-li aktivní, kontrola před zpracováním modelem zpracuje vstupní obrázek a ověří, zda obsahuje obličej.
povinné Kanonický název, také podporován

Parametry souborů přijímají veřejnou adresu https:// URL, data: URI do 10 MB nebo file_url nahraného souboru. Soubory

Výstup

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"
  }
}
Vaše soubory, vaše volbaKaždý outputs[].url je kopie v našem úložišti: uchovávaná navždy (zpoplatněná za GB-měsíc) nebo 7 dne zdarma podle nastavení účtu nebo ?storage=.
Stejná struktura u každého modelutype, url, content_type, width, height a duration pro obrázky, video i zvuk. output je vlastní objekt výsledku modelu.
Pole výstupu
video
object {url, content_type, file_name, file_size}Video soubor vytvořený generováním.

Další modely: Synchronizace rtů a avataři

Pro AI agenty: tato stránka je ve formátu Markdown na adrese https://doitong.com/cs/developers/models/live-portrait.md. Všechny modely a návody: https://doitong.com/developers/llms.txt