Μετάβαση στο περιεχόμενο

Live Portrait

Ενσωμάτωση

id μοντέλου 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"

Έως 4,50 $ ανά εκτέλεση χρέωση βάσει της πραγματικής χρήσης, το υπόλοιπο επιστρέφεται Εκτέλεση σε αυτήν τη σελίδα

Λήψη κλειδιού API
Kuaishou Συγχρονισμός χειλιών και άβαταρ Συγχρονισμός χειλιών #expression#animation

Κινεί μια εικόνα πορτρέτου με εκφράσεις από βίντεο καθοδήγησης, με λεπτομερείς ελέγχους προσώπου

Kuaishou · Βίντεο

Το πρώτο σας αποτέλεσμα θα εμφανιστεί εδώ

Δημιουργήστε ένα αίτημα παρακάτω και εκτελέστε το με το κλειδί API σας. Οι έξοδοι αντιγράφονται στην αποθήκευσή μας και διατηρούνται για πάντα ή 7 ημέρες δωρεάν.

Δημιουργία αιτήματος

Τα στοιχεία ελέγχου δημιουργούνται από το σχήμα του μοντέλου. Ο κώδικας και η τιμή ενημερώνονται καθώς τα αλλάζετε.

•απαιτείται video_url
Αποθέστε ένα αρχείο ή

URL βίντεο που χρησιμοποιείται για τον συγχρονισμό χειλιών.

•απαιτείται image_url
Αποθέστε ένα αρχείο ή

URL εικόνας για animation.

Για προχωρημένους 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
προεπιλογή 0
προεπιλογή 0

Βαθμός ανύψωσης ή χαμηλώματος των φρυδιών.

προεπιλογή 0

Βαθμός κλεισίματος του ενός ματιού.

προεπιλογή 0

Ποσότητα οριζόντιας κίνησης της κόρης.

προεπιλογή 0

Ποσότητα κατακόρυφης κίνησης της κόρης.

προεπιλογή 0

Βαθμός ανοίγματος του στόματος στο σχήμα 'aaa'.

προεπιλογή 0

Βαθμός διαμόρφωσης του στόματος στη θέση 'eee'.

προεπιλογή 0

Βαθμός διαμόρφωσης του στόματος στη θέση 'woo'.

προεπιλογή 0

Βαθμός χαμόγελου.

προεπιλογή 0

Ποσότητα περιστροφής του προσώπου κατά τον άξονα pitch.

προεπιλογή 0

Ποσότητα περιστροφής του προσώπου κατά τον άξονα yaw.

προεπιλογή 0

Ποσότητα περιστροφής του προσώπου κατά τον άξονα roll.

προεπιλογή 512

Διαστάσεις της εικόνας που προκύπτει.

προεπιλογή 2.3

Πολλαπλασιαστής κλίμακας που εφαρμόζεται στο face crop.

προεπιλογή 0

Αναλογία που ελέγχει την οριζόντια μετατόπιση του face crop.

προεπιλογή -0.125

Αναλογία κατακόρυφης τοποθέτησης face-crop: το πρόσημο καθορίζει την κατεύθυνση, προς τα πάνω για θετικές τιμές και προς τα κάτω για αρνητικές.

προεπιλογή 32

Μέγεθος batch του μοντέλου, με συμβιβασμό ταχύτητας–μνήμης: η αύξησή του χρησιμοποιεί περισσότερη μνήμη για ταχύτερη εκτέλεση.

POST /run/live-portrait?wait=20 προσφορά → 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"

Εκτέλεση αυτού του αιτήματος

Το κλειδί σας παραμένει σε αυτό το πρόγραμμα περιήγησης: αποστέλλεται μόνο στο Doitong API και αποθηκεύεται (localStorage) μόνο αν ενεργοποιήσετε την επιλογή «Να απομνημονεύεται». Λήψη κλειδιού API

Σχετικά με το Live Portrait

Μεταφέρει την κίνηση του προσώπου από βίντεο καθοδήγησης σε στατικό πορτρέτο, δημιουργώντας βίντεο. Εκτός από `video_url` και `image_url`, προσφέρει αριθμητικούς ελέγχους για ανοιγοκλείσιμο ματιών, φρύδια, κλείσιμο ενός ματιού, κόρες, σχήματα στόματος (aaa, eee, woo), χαμόγελο και περιστροφή κεφαλής σε pitch, yaw και roll. Διατίθενται επιλογές περικοπής και επικόλλησης, όπως `flag_do_crop` και `flag_pasteback`, ενώ το `dsize` ορίζει το μέγεθος εξόδου (προεπιλογή 512).

Παράμετροι

Στείλτε είτε το κανονικό όνομα είτε το εγγενές όνομα, όχι και τα δύο. Κανονικά ονόματα

ΌνομαΤύπος ΠροεπιλογήΕπιτρεπόμενο Περιγραφή
video_urlαπαιτείται video
Τύποςurl · video
URL βίντεο που χρησιμοποιείται για τον συγχρονισμό χειλιών.
image_urlαπαιτείται image
Τύποςurl · image
URL εικόνας για animation.
eyebrowπροαιρετικό
Τύποςnumber
Προεπιλογή0
-30 – 30
Βαθμός ανύψωσης ή χαμηλώματος των φρυδιών.
winkπροαιρετικό
Τύποςnumber
Προεπιλογή0
0 – 25
Βαθμός κλεισίματος του ενός ματιού.
pupil_xπροαιρετικό
Τύποςnumber
Προεπιλογή0
-45 – 45
Ποσότητα οριζόντιας κίνησης της κόρης.
pupil_yπροαιρετικό
Τύποςnumber
Προεπιλογή0
-45 – 45
Ποσότητα κατακόρυφης κίνησης της κόρης.
aaaπροαιρετικό
Τύποςnumber
Προεπιλογή0
-200 – 200
Βαθμός ανοίγματος του στόματος στο σχήμα 'aaa'.
eeeπροαιρετικό
Τύποςnumber
Προεπιλογή0
-40 – 40
Βαθμός διαμόρφωσης του στόματος στη θέση 'eee'.
wooπροαιρετικό
Τύποςnumber
Προεπιλογή0
-100 – 100
Βαθμός διαμόρφωσης του στόματος στη θέση 'woo'.
smileπροαιρετικό
Τύποςnumber
Προεπιλογή0
-2 – 2
Βαθμός χαμόγελου.
flag_lip_zeroπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Κλείσιμο χειλιών πριν από το animation, εφαρμόσιμο μόνο όταν τα flag_eye_retargeting και flag_lip_retargeting έχουν οριστεί σε False.
rotate_pitchπροαιρετικό
Τύποςnumber
Προεπιλογή0
-45 – 45
Ποσότητα περιστροφής του προσώπου κατά τον άξονα pitch.
rotate_yawπροαιρετικό
Τύποςnumber
Προεπιλογή0
-45 – 45
Ποσότητα περιστροφής του προσώπου κατά τον άξονα yaw.
rotate_rollπροαιρετικό
Τύποςnumber
Προεπιλογή0
-45 – 45
Ποσότητα περιστροφής του προσώπου κατά τον άξονα roll.
flag_eye_retargetingπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Εναλλαγή retargeting ματιών.
flag_lip_retargetingπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Εναλλαγή retargeting χειλιών.
flag_stitchingπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Εναλλαγή stitching· συνιστάται η ενεργοποίησή της.
flag_relativeπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Εναλλαγή σχετικής κίνησης.
flag_pastebackπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Επιλογή paste-back/stitching που τοποθετεί το animated crop προσώπου στην αρχική εικόνα, αντιστοιχίζοντάς το εκτός των συντεταγμένων face-crop.
flag_do_cropπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Ελέγχει αν το πορτρέτο-πηγή περικόπτεται στον χώρο συντεταγμένων face-crop.
flag_do_rotπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Ελέγχει αν εκτελείται περιστροφή όταν το flag_do_crop είναι true.
dsizeπροαιρετικό
Τύποςinteger
Προεπιλογή512
Διαστάσεις της εικόνας που προκύπτει.
scaleπροαιρετικό
Τύποςnumber
Προεπιλογή2.3
Πολλαπλασιαστής κλίμακας που εφαρμόζεται στο face crop.
vx_ratioπροαιρετικό
Τύποςnumber
Προεπιλογή0
Αναλογία που ελέγχει την οριζόντια μετατόπιση του face crop.
vy_ratioπροαιρετικό
Τύποςnumber
Προεπιλογή-0.125
Αναλογία κατακόρυφης τοποθέτησης face-crop: το πρόσημο καθορίζει την κατεύθυνση, προς τα πάνω για θετικές τιμές και προς τα κάτω για αρνητικές.
batch_sizeπροαιρετικό
Τύποςinteger
Προεπιλογή32
Μέγεθος batch του μοντέλου, με συμβιβασμό ταχύτητας–μνήμης: η αύξησή του χρησιμοποιεί περισσότερη μνήμη για ταχύτερη εκτέλεση.
enable_safety_checkerπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Ελέγχει αν είναι ενεργοποιημένος ο έλεγχος ασφάλειας. Όταν ενεργοποιείται, ο ελεγκτής επεξεργάζεται την εικόνα εισόδου για να επαληθεύσει ότι περιέχει πρόσωπο πριν από την επεξεργασία του μοντέλου.
απαιτείται Κανονικό όνομα, επίσης αποδεκτό

Οι παράμετροι αρχείων δέχονται ένα δημόσιο URL https://, ένα URI data: έως 10 MB ή το file_url μιας μεταφόρτωσης. Αρχεία

Έξοδος

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"
  }
}
Τα αρχεία σας, η επιλογή σαςΚάθε outputs[].url είναι ένα αντίγραφο στην αποθήκευσή μας: διατηρείται για πάντα (χρέωση ανά GB-μήνα) ή 7 ημέρες δωρεάν, σύμφωνα με τη ρύθμιση του λογαριασμού σας ή ?storage=.
Ίδια μορφή σε κάθε μοντέλοtype, url, content_type, width, height και duration, τόσο για εικόνες όσο και για βίντεο και ήχο. Το output είναι το αντικείμενο αποτελέσματος του ίδιου του μοντέλου.
Πεδία εξόδου
video
object {url, content_type, file_name, file_size}Αρχείο βίντεο που παράγεται από την παραγωγή.

Περισσότερα μοντέλα: Συγχρονισμός χειλιών και άβαταρ

Για πράκτορες AI: αυτή η σελίδα σε Markdown βρίσκεται στη διεύθυνση https://doitong.com/el/developers/models/live-portrait.md. Όλα τα μοντέλα και οι οδηγοί: https://doitong.com/developers/llms.txt