Ir al contenido

Live Portrait

Integrar

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

Hasta 4,50 $ por ejecución se cobra según el uso real y el resto se reembolsa Ejecutar en esta página

Obtener clave de API
Kuaishou Sincronización labial y avatares Sincronización labial #expression#animation

Anima una imagen de retrato con expresiones tomadas de un vídeo guía, con controles faciales precisos

Kuaishou · Vídeo

Tu primer resultado aparecerá aquí

Crea una solicitud a continuación y ejecútala con tu clave de API. Las salidas se copian en nuestro almacenamiento, conservadas para siempre o 7 días gratis.

Crear una solicitud

Los controles se generan a partir del esquema del modelo. El código y el precio se actualizan al modificarlos.

•obligatorio video_url
Suelta un archivo o

URL del vídeo utilizada para controlar la sincronización labial.

•obligatorio image_url
Suelta un archivo o

URL de la imagen para la animación.

Avanzado 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
predeterminado 0
predeterminado 0

Grado de elevación o descenso de las cejas.

predeterminado 0

Grado de guiño.

predeterminado 0

Cantidad de movimiento horizontal de las pupilas.

predeterminado 0

Cantidad de movimiento vertical de las pupilas.

predeterminado 0

Grado de apertura de la boca en forma de 'aaa'.

predeterminado 0

Grado de colocación de la boca en la posición 'eee'.

predeterminado 0

Grado de colocación de la boca en la posición 'woo'.

predeterminado 0

Grado de sonrisa.

predeterminado 0

Cantidad de rotación de la cara sobre el eje de cabeceo.

predeterminado 0

Cantidad de rotación de la cara sobre el eje de guiñada.

predeterminado 0

Cantidad de rotación de la cara sobre el eje de alabeo.

predeterminado 512

Dimensiones de la imagen resultante.

predeterminado 2.3

Multiplicador de escala aplicado al recorte facial.

predeterminado 0

Relación que controla el desplazamiento horizontal del recorte facial.

predeterminado -0.125

Relación de posición vertical del recorte facial: el signo determina la dirección, hacia arriba para valores positivos y hacia abajo para valores negativos.

predeterminado 32

Tamaño del lote del modelo, con un equilibrio entre velocidad y memoria: aumentarlo utiliza más memoria a cambio de una ejecución más rápida.

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

Ejecutar esta solicitud

Tu clave permanece en este navegador: solo se envía a la Doitong API y solo se guarda en localStorage si marcas Recordar. Obtener una clave de API

Acerca de Live Portrait

Transfiere el movimiento facial de un vídeo guía a un retrato fijo y produce un vídeo. Además de `video_url` e `image_url`, ofrece controles numéricos para el parpadeo, las cejas, el guiño, las pupilas, las formas de la boca (aaa, eee, woo), la sonrisa y la rotación de la cabeza en pitch, yaw y roll. Hay opciones de recorte y composición, como `flag_do_crop` y `flag_pasteback`, y `dsize` establece el tamaño de salida (512 de forma predeterminada).

Parámetros

Envía el nombre canónico o el nombre nativo, pero no ambos. Nombres canónicos

NombreTipo PredeterminadoPermitido Descripción
video_urlobligatorio video
Tipourl · video
URL del vídeo utilizada para controlar la sincronización labial.
image_urlobligatorio image
Tipourl · image
URL de la imagen para la animación.
eyebrowopcional
Tiponumber
Predeterminado0
-30 – 30
Grado de elevación o descenso de las cejas.
winkopcional
Tiponumber
Predeterminado0
0 – 25
Grado de guiño.
pupil_xopcional
Tiponumber
Predeterminado0
-45 – 45
Cantidad de movimiento horizontal de las pupilas.
pupil_yopcional
Tiponumber
Predeterminado0
-45 – 45
Cantidad de movimiento vertical de las pupilas.
aaaopcional
Tiponumber
Predeterminado0
-200 – 200
Grado de apertura de la boca en forma de 'aaa'.
eeeopcional
Tiponumber
Predeterminado0
-40 – 40
Grado de colocación de la boca en la posición 'eee'.
wooopcional
Tiponumber
Predeterminado0
-100 – 100
Grado de colocación de la boca en la posición 'woo'.
smileopcional
Tiponumber
Predeterminado0
-2 – 2
Grado de sonrisa.
flag_lip_zeroopcional
Tipoboolean
Predeterminadotrue
Cierre labial previo a la animación, aplicable solo cuando flag_eye_retargeting y flag_lip_retargeting están establecidos en False.
rotate_pitchopcional
Tiponumber
Predeterminado0
-45 – 45
Cantidad de rotación de la cara sobre el eje de cabeceo.
rotate_yawopcional
Tiponumber
Predeterminado0
-45 – 45
Cantidad de rotación de la cara sobre el eje de guiñada.
rotate_rollopcional
Tiponumber
Predeterminado0
-45 – 45
Cantidad de rotación de la cara sobre el eje de alabeo.
flag_eye_retargetingopcional
Tipoboolean
Predeterminadofalse
Activador de redireccionamiento de los ojos.
flag_lip_retargetingopcional
Tipoboolean
Predeterminadofalse
Activador de redireccionamiento de los labios.
flag_stitchingopcional
Tipoboolean
Predeterminadotrue
Activador de unión; se recomienda habilitarlo.
flag_relativeopcional
Tipoboolean
Predeterminadotrue
Activador de movimiento relativo.
flag_pastebackopcional
Tipoboolean
Predeterminadotrue
Opción de pegar de nuevo/unir que coloca el recorte de la cara animada en la imagen original, transformándolo desde las coordenadas del recorte facial.
flag_do_cropopcional
Tipoboolean
Predeterminadotrue
Controla si el retrato de origen se recorta al espacio de coordenadas del recorte facial.
flag_do_rotopcional
Tipoboolean
Predeterminadotrue
Controla si se realiza la rotación cuando flag_do_crop es true.
dsizeopcional
Tipointeger
Predeterminado512
Dimensiones de la imagen resultante.
scaleopcional
Tiponumber
Predeterminado2.3
Multiplicador de escala aplicado al recorte facial.
vx_ratioopcional
Tiponumber
Predeterminado0
Relación que controla el desplazamiento horizontal del recorte facial.
vy_ratioopcional
Tiponumber
Predeterminado-0.125
Relación de posición vertical del recorte facial: el signo determina la dirección, hacia arriba para valores positivos y hacia abajo para valores negativos.
batch_sizeopcional
Tipointeger
Predeterminado32
Tamaño del lote del modelo, con un equilibrio entre velocidad y memoria: aumentarlo utiliza más memoria a cambio de una ejecución más rápida.
enable_safety_checkeropcional
Tipoboolean
Predeterminadofalse
Controla si la comprobación de seguridad está habilitada. Cuando está activa, el comprobador procesa la imagen de entrada para verificar que contiene una cara antes del procesamiento del modelo.
obligatorio Nombre canónico, también aceptado

Los parámetros de archivo aceptan una URL pública https://, un URI data: de hasta 10 MB o el file_url de una subida. Archivos

Salida

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"
  }
}
Tus archivos, tú eligesCada outputs[].url es una copia en nuestro almacenamiento: conservada para siempre (con pago por GB-mes) o 7 días gratis, según la configuración de tu cuenta o ?storage=.
La misma estructura en todos los modelostype, url, content_type, width, height y duration, tanto para imágenes como para vídeo y audio. output es el objeto de resultado propio del modelo.
Campos de salida
video
object {url, content_type, file_name, file_size}Archivo de vídeo producido por la generación.

Más modelos: Sincronización labial y avatares

Para agentes de IA: esta página en Markdown está en https://doitong.com/es-ES/developers/models/live-portrait.md. Todos los modelos y guías: https://doitong.com/developers/llms.txt