Saltar al cuntegna

Live Portrait

Integrar

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

Fin a $4,50 per execuziun pajà tenor l'utilisaziun effectiva, il rest vegn restituì Lantschar sin questa pagina

Obtegna ina clav API
Kuaishou Lipsync e avatars Lipsync #expression#animation

Animescha in maletg da purtret cun expressiuns d’in video da pilot, cun controllas finas da la fatscha

Kuaishou · Video

Tes emprim resultat vegn qua

Construis ina dumonda sutvart e l'exequescha cun tia clav API. Outputs vegnan copiads en nossa memorisaziun, conservads per adina u 7 dis gratuitamain.

Construir ina dumonda

Ils controls vegnan generads dal schema dal model. Il code e ​​il pretsch s'actualiseschan durant che ti als midas.

•obligatori video_url
Trametta in datoteca u

URL dal video utilisada per manar la sincronisaziun dals lefs.

•obligatori image_url
Trametta in datoteca u

URL dal maletg per l'animaziun.

Avanzà 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
standard 0
standard 0

Grad d'auzar u sbassar las surcigliadas.

standard 0

Grad da strischar cun in egl.

standard 0

Quantitad dal moviment orizontal da la pupilla.

standard 0

Quantitad dal moviment vertical da la pupilla.

standard 0

Grad d'avertura da la bucca en la furma 'aaa'.

standard 0

Grad da furmaziun da la bucca en la posiziun 'eee'.

standard 0

Grad da furmaziun da la bucca en la posiziun 'woo'.

standard 0

Grad dal surrir.

standard 0

Quantitad da rotaziun da la fatscha sin l'axa pitch.

standard 0

Quantitad da rotaziun da la fatscha sin l'axa yaw.

standard 0

Quantitad da rotaziun da la fatscha sin l'axa roll.

standard 512

Dimensiuns dal maletg resultà.

standard 2.3

Multiplicatur da scala applitgà al crop da la fatscha.

standard 0

Relaziun che controlla l'offset orizontal dal crop da la fatscha.

standard -0.125

Relaziun dal posiziunament vertical dal crop da la fatscha: il segn determinescha la direcziun, ensi per valurs positivas ed engiu per negativas.

standard 32

Grondezza dal batch dal model, cun in barat sveltezza–memoria: l'augmentar dovra dapli memoria en barat per in'execuziun pli svelta.

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

Executar questa dumonda

Tia clav resta en quest browser: ella vegn tramessa mo al Doitong API e memorisada (localStorage) mo sch'ella scheccas Tiar a memoria. Obtegnair ina clav API

Davart Live Portrait

Transfierescha il moviment facial d’in video da pilot sin in purtret static e producescha in video. Sper `video_url` e `image_url` porscha el controllas numericas per clignar, survants, clin, pupillas, furmas da bucca (aaa, eee, woo), surrir e rotaziun da la testa en pitch, yaw e roll. Opziuns da tagliar e collar sco `flag_do_crop` e `flag_pasteback` èn disponiblas, e `dsize` fixescha la grondezza da l’output (standard 512).

Parameters

Invia u il num canonic u il num nativ, betg omaduas. Nums canonics

NumTip StandardPermess Descripziun
video_urlobligatori video
Tipurl · video
URL dal video utilisada per manar la sincronisaziun dals lefs.
image_urlobligatori image
Tipurl · image
URL dal maletg per l'animaziun.
eyebrowopziunal
Tipnumber
Standard0
-30 – 30
Grad d'auzar u sbassar las surcigliadas.
winkopziunal
Tipnumber
Standard0
0 – 25
Grad da strischar cun in egl.
pupil_xopziunal
Tipnumber
Standard0
-45 – 45
Quantitad dal moviment orizontal da la pupilla.
pupil_yopziunal
Tipnumber
Standard0
-45 – 45
Quantitad dal moviment vertical da la pupilla.
aaaopziunal
Tipnumber
Standard0
-200 – 200
Grad d'avertura da la bucca en la furma 'aaa'.
eeeopziunal
Tipnumber
Standard0
-40 – 40
Grad da furmaziun da la bucca en la posiziun 'eee'.
wooopziunal
Tipnumber
Standard0
-100 – 100
Grad da furmaziun da la bucca en la posiziun 'woo'.
smileopziunal
Tipnumber
Standard0
-2 – 2
Grad dal surrir.
flag_lip_zeroopziunal
Tipboolean
Standardtrue
Serrar ils lefs avant l'animaziun, applitgabel mo sche flag_eye_retargeting e flag_lip_retargeting èn mess a False.
rotate_pitchopziunal
Tipnumber
Standard0
-45 – 45
Quantitad da rotaziun da la fatscha sin l'axa pitch.
rotate_yawopziunal
Tipnumber
Standard0
-45 – 45
Quantitad da rotaziun da la fatscha sin l'axa yaw.
rotate_rollopziunal
Tipnumber
Standard0
-45 – 45
Quantitad da rotaziun da la fatscha sin l'axa roll.
flag_eye_retargetingopziunal
Tipboolean
Standardfalse
Activaziun da retargeting dals egls.
flag_lip_retargetingopziunal
Tipboolean
Standardfalse
Activaziun da retargeting dals lefs.
flag_stitchingopziunal
Tipboolean
Standardtrue
Activaziun da stitching; activar quai è recumandà.
flag_relativeopziunal
Tipboolean
Standardtrue
Activaziun dal moviment relativ.
flag_pastebackopziunal
Tipboolean
Standardtrue
Opziun da paste-back/stitching che plazzescha il crop animà da la fatscha en il maletg original e mappa el or da las coordinatas dal crop da la fatscha.
flag_do_cropopziunal
Tipboolean
Standardtrue
Controlla sche il purtret da funtauna vegn taglià en il spazi da coordinatas dal crop da la fatscha.
flag_do_rotopziunal
Tipboolean
Standardtrue
Controlla sche la rotaziun vegn fatga sche flag_do_crop è true.
dsizeopziunal
Tipinteger
Standard512
Dimensiuns dal maletg resultà.
scaleopziunal
Tipnumber
Standard2.3
Multiplicatur da scala applitgà al crop da la fatscha.
vx_ratioopziunal
Tipnumber
Standard0
Relaziun che controlla l'offset orizontal dal crop da la fatscha.
vy_ratioopziunal
Tipnumber
Standard-0.125
Relaziun dal posiziunament vertical dal crop da la fatscha: il segn determinescha la direcziun, ensi per valurs positivas ed engiu per negativas.
batch_sizeopziunal
Tipinteger
Standard32
Grondezza dal batch dal model, cun in barat sveltezza–memoria: l'augmentar dovra dapli memoria en barat per in'execuziun pli svelta.
enable_safety_checkeropziunal
Tipboolean
Standardfalse
Controlla sche la controlla da segirezza è activada. Sche activa, il controllader elavura il maletg d'input per verifitgar ch'el cuntegna ina fatscha avant l'elavuraziun dal model.
obligatori Num canonic, er acceptà

Ils parameters da datotecas acceptan ina URL publica https://, ina URI data: fin a 10 MB u il file_url d'ina chargiada. Datotecas

Output

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"
  }
}
Tias datotecas, tia decisiunMintga outputs[].url è ina copia en nossa memorisaziun: conservada per adina (pajà per GB-mes) u 7 dis gratuitamain, tenor la configuraziun dal conto u ?storage=.
La medema structura per mintga modeltype, url, content_type, width, height e duration, tant per maletgs sco per video e audio. output è l'object da resultat dal model sez.
Champs da l'output
video
object {url, content_type, file_name, file_size}Datoteca video producida da la generaziun.

Dapli models: Lipsync e avatars

Per agents AI: questa pagina sco Markdown è disponibla sut https://doitong.com/rm/developers/models/live-portrait.md. Tut ils models e las guidas: https://doitong.com/developers/llms.txt