Passer au contenu

Live Portrait

Intégrer

Identifiant du modèle 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"

Jusqu’à 4,50 $ par exécution facturé selon l’utilisation réelle, le reste est remboursé L’exécuter sur cette page

Obtenir une clé API
Kuaishou Synchronisation labiale et avatars Synchronisation labiale #expression#animation

Anime une image de portrait avec des expressions extraites d’une vidéo de pilotage, avec des contrôles précis du visage

Kuaishou · Vidéo

Votre premier résultat apparaîtra ici

Créez une requête ci-dessous et exécutez-la avec votre clé API. Les sorties sont copiées dans notre stockage, conservées indéfiniment ou pendant 7 jours gratuitement.

Créer une requête

Les contrôles sont générés à partir du schéma du modèle. Le code et le prix se mettent à jour au fur et à mesure de vos modifications.

•requis video_url
Déposez un fichier ou

URL vidéo utilisée pour piloter la synchronisation des lèvres.

•requis image_url
Déposez un fichier ou

URL d’image pour l’animation.

Avancé 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
par défaut 0
par défaut 0

Degré de haussement ou d’abaissement des sourcils.

par défaut 0

Degré de clin d’œil.

par défaut 0

Ampleur du mouvement horizontal des pupilles.

par défaut 0

Ampleur du mouvement vertical des pupilles.

par défaut 0

Degré d’ouverture de la bouche en forme 'aaa'.

par défaut 0

Degré de positionnement de la bouche en forme 'eee'.

par défaut 0

Degré de positionnement de la bouche en forme 'woo'.

par défaut 0

Degré de sourire.

par défaut 0

Ampleur de la rotation du visage autour de l’axe de tangage.

par défaut 0

Ampleur de la rotation du visage autour de l’axe de lacet.

par défaut 0

Ampleur de la rotation du visage autour de l’axe de roulis.

par défaut 512

Dimensions de l’image résultante.

par défaut 2.3

Multiplicateur d’échelle appliqué au recadrage du visage.

par défaut 0

Rapport contrôlant le décalage horizontal du recadrage du visage.

par défaut -0.125

Rapport de positionnement vertical du recadrage du visage : le signe détermine la direction, vers le haut pour les valeurs positives et vers le bas pour les valeurs négatives.

par défaut 32

Taille du lot du modèle, avec un compromis vitesse–mémoire : l’augmenter utilise davantage de mémoire en échange d’une exécution plus rapide.

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

Exécuter cette requête

Votre clé reste dans ce navigateur : elle est envoyée uniquement au Doitong API et enregistrée dans localStorage uniquement si vous cochez Mémoriser. Obtenir une clé API

À propos de Live Portrait

Transfère les mouvements du visage d’une vidéo de pilotage sur un portrait fixe pour produire une vidéo. En plus de `video_url` et `image_url`, le modèle offre des contrôles numériques pour le clignement, les sourcils, le clin d’œil, les pupilles, les formes de la bouche (aaa, eee, woo), le sourire et la rotation de la tête selon le tangage, le lacet et le roulis. Des options de recadrage et d’assemblage comme `flag_do_crop` et `flag_pasteback` sont disponibles, et `dsize` définit la taille de sortie (512 par défaut).

Paramètres

Envoyez soit le nom canonique, soit le nom natif, mais pas les deux. Noms canoniques

NomType Par défautAutorisé Description
video_urlrequis video
Typeurl · video
URL vidéo utilisée pour piloter la synchronisation des lèvres.
image_urlrequis image
Typeurl · image
URL d’image pour l’animation.
eyebrowfacultatif
Typenumber
Par défaut0
-30 – 30
Degré de haussement ou d’abaissement des sourcils.
winkfacultatif
Typenumber
Par défaut0
0 – 25
Degré de clin d’œil.
pupil_xfacultatif
Typenumber
Par défaut0
-45 – 45
Ampleur du mouvement horizontal des pupilles.
pupil_yfacultatif
Typenumber
Par défaut0
-45 – 45
Ampleur du mouvement vertical des pupilles.
aaafacultatif
Typenumber
Par défaut0
-200 – 200
Degré d’ouverture de la bouche en forme 'aaa'.
eeefacultatif
Typenumber
Par défaut0
-40 – 40
Degré de positionnement de la bouche en forme 'eee'.
woofacultatif
Typenumber
Par défaut0
-100 – 100
Degré de positionnement de la bouche en forme 'woo'.
smilefacultatif
Typenumber
Par défaut0
-2 – 2
Degré de sourire.
flag_lip_zerofacultatif
Typeboolean
Par défauttrue
Fermeture des lèvres avant l’animation, applicable uniquement lorsque flag_eye_retargeting et flag_lip_retargeting sont tous deux définis sur False.
rotate_pitchfacultatif
Typenumber
Par défaut0
-45 – 45
Ampleur de la rotation du visage autour de l’axe de tangage.
rotate_yawfacultatif
Typenumber
Par défaut0
-45 – 45
Ampleur de la rotation du visage autour de l’axe de lacet.
rotate_rollfacultatif
Typenumber
Par défaut0
-45 – 45
Ampleur de la rotation du visage autour de l’axe de roulis.
flag_eye_retargetingfacultatif
Typeboolean
Par défautfalse
Commutateur de reciblage des yeux.
flag_lip_retargetingfacultatif
Typeboolean
Par défautfalse
Commutateur de reciblage des lèvres.
flag_stitchingfacultatif
Typeboolean
Par défauttrue
Commutateur d’assemblage; son activation est recommandée.
flag_relativefacultatif
Typeboolean
Par défauttrue
Commutateur de mouvement relatif.
flag_pastebackfacultatif
Typeboolean
Par défauttrue
Option de remise en place/assemblage qui insère le recadrage du visage animé dans l’image originale, en le convertissant depuis les coordonnées du recadrage du visage.
flag_do_cropfacultatif
Typeboolean
Par défauttrue
Contrôle si le portrait source est recadré dans l’espace de coordonnées du recadrage du visage.
flag_do_rotfacultatif
Typeboolean
Par défauttrue
Contrôle si la rotation est effectuée lorsque flag_do_crop vaut true.
dsizefacultatif
Typeinteger
Par défaut512
Dimensions de l’image résultante.
scalefacultatif
Typenumber
Par défaut2.3
Multiplicateur d’échelle appliqué au recadrage du visage.
vx_ratiofacultatif
Typenumber
Par défaut0
Rapport contrôlant le décalage horizontal du recadrage du visage.
vy_ratiofacultatif
Typenumber
Par défaut-0.125
Rapport de positionnement vertical du recadrage du visage : le signe détermine la direction, vers le haut pour les valeurs positives et vers le bas pour les valeurs négatives.
batch_sizefacultatif
Typeinteger
Par défaut32
Taille du lot du modèle, avec un compromis vitesse–mémoire : l’augmenter utilise davantage de mémoire en échange d’une exécution plus rapide.
enable_safety_checkerfacultatif
Typeboolean
Par défautfalse
Contrôle si la vérification de sécurité est activée. Lorsqu’elle est active, le vérificateur traite l’image d’entrée pour confirmer qu’elle contient un visage avant le traitement par le modèle.
requis Nom canonique, également accepté

Les paramètres de fichier acceptent une URL publique https://, un URI data: jusqu’à 10 MB ou le file_url d’un téléversement. Fichiers

Sortie

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"
  }
}
Vos fichiers, votre choixChaque outputs[].url est une copie dans notre stockage : conservée indéfiniment (facturation par Go-mois) ou pendant 7 jours gratuitement, selon le réglage de votre compte ou ?storage=.
Même structure pour chaque modèletype, url, content_type, width, height et duration, pour les images, les vidéos et les fichiers audio. output est l’objet de résultat propre au modèle.
Champs de sortie
video
object {url, content_type, file_name, file_size}Fichier vidéo produit par la génération.

Plus de modèles : Synchronisation labiale et avatars

Pour les agents IA : cette page en Markdown se trouve à https://doitong.com/fr-CA/developers/models/live-portrait.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt