Accéder au contenu

Live Portrait · Image

Intégrer

Identifiant du modèle live-portrait/image
# 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/image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.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’à 1,125 $ par exécution facturation selon l'utilisation réelle, le reste est remboursé L'exécuter sur cette page

Obtenir une clé API
Kuaishou Édition d’image #expression#animation

Modifie l’expression et la pose de tête d’un portrait unique à l’aide de curseurs, avec une image fixe en sortie

Kuaishou · Image

Votre premier résultat apparaîtra ici

Construisez 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 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 lorsque vous les modifiez.

•obligatoire image_url
Déposez un fichier ou

URL de l’image à animer.

Avancé output_format · blink · eyebrow · wink · pupil_x · pupil_y · aaa · eee · woo · smile · rotate_pitch · rotate_yaw · rotate_roll · dsize · scale · vx_ratio · vy_ratio · flag_pasteback · flag_do_crop · flag_do_rot · flag_lip_zero · enable_safety_checker
output_format par défaut jpeg

Format utilisé pour la sortie.

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

Amplitude du mouvement horizontal des pupilles.

par défaut 0

Amplitude du mouvement vertical des pupilles.

par défaut 0

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

par défaut 0

Degré de formation de la bouche en position 'eee'.

par défaut 0

Degré de formation de la bouche en position 'woo'.

par défaut 0

Degré du sourire.

par défaut 0

Amplitude de rotation du visage autour de l’axe de tangage.

par défaut 0

Amplitude de rotation du visage autour de l’axe de lacet.

par défaut 0

Amplitude de 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.

POST /run/live-portrait/image?wait=20 devis → 1,125 $
# 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/image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.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 à la Doitong API et enregistrée dans localStorage uniquement si vous cochez Mémoriser. Obtenir une clé API

À propos de Live Portrait · Image

Ajuste le visage d’une photo de portrait sans vidéo de pilotage. Les curseurs couvrent le clignement, les sourcils, le clin d’œil, la position des pupilles, les formes de la bouche (aaa, eee, woo), le sourire et la rotation de la tête (pitch, yaw, roll). Les options de recadrage telles que `flag_do_crop` et `scale`, ainsi que `dsize` (512 par défaut), contrôlent le recadrage du visage. La sortie est en jpeg par défaut, ou en png.

Paramètres

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

NomType Par défautAutorisé Description
image_urlobligatoire image
Typeurl · image
URL de l’image à animer.
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
Amplitude du mouvement horizontal des pupilles.
pupil_yfacultatif
Typenumber
Par défaut0
-45 – 45
Amplitude du mouvement vertical des pupilles.
aaafacultatif
Typenumber
Par défaut0
-200 – 200
Degré d’ouverture de la bouche en forme de 'aaa'.
eeefacultatif
Typenumber
Par défaut0
-40 – 40
Degré de formation de la bouche en position 'eee'.
woofacultatif
Typenumber
Par défaut0
-100 – 100
Degré de formation de la bouche en position 'woo'.
smilefacultatif
Typenumber
Par défaut0
-2 – 2
Degré du sourire.
rotate_pitchfacultatif
Typenumber
Par défaut0
-45 – 45
Amplitude de rotation du visage autour de l’axe de tangage.
rotate_yawfacultatif
Typenumber
Par défaut0
-45 – 45
Amplitude de rotation du visage autour de l’axe de lacet.
rotate_rollfacultatif
Typenumber
Par défaut0
-45 – 45
Amplitude de rotation du visage autour de l’axe de roulis.
flag_pastebackfacultatif
Typeboolean
Par défauttrue
Option de réinsertion/assemblage qui place le recadrage du visage animé dans l’image originale en le mappant hors des 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.
flag_lip_zerofacultatif
Typeboolean
Par défauttrue
Fermeture des lèvres avant l’animation, applicable uniquement lorsque flag_eye_retargeting et flag_lip_retargeting valent tous deux False.
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.
enable_safety_checkerfacultatif
Typeboolean
Par défautfalse
Contrôle l’activation du contrôle de sécurité. Lorsqu’il est actif, le contrôleur traite l’image d’entrée pour vérifier qu’elle contient un visage avant le traitement par le modèle.
output_formatfacultatif
Typeenum
Par défautjpeg
jpegpng
Format utilisé pour la sortie.
obligatoire 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/image",
  "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": 1125,
    "usd": "1.125",
    "charged": 1125,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "image": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768
    }
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "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 sur notre stockage : conservée indéfiniment (facturation par Go-mois) ou 7 jours gratuitement, selon le réglage de votre compte ou ?storage=.
Une structure identique pour chaque modèletype, url, content_type, width, height et duration, pour les images, les vidéos et l'audio. output est l'objet de résultat propre au modèle.
Champs de sortie
image
object {url, content_type, file_name, file_size, width, height}Fichier image produit par la génération.

Plus de modèles : Édition d’image

Pour les agents IA : cette page au format Markdown est disponible à l'adresse https://doitong.com/fr-FR/developers/models/live-portrait/image.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt