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

Live Portrait · Image

Ενσωμάτωση

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

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

Λήψη κλειδιού API
Kuaishou Επεξεργασία εικόνας #expression#animation

Επεξεργάζεται την έκφραση και τη στάση κεφαλής ενός πορτρέτου με ρυθμιστικά,输出οντας στατική εικόνα

Kuaishou · Εικόνα

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

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

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

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

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

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

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

Μορφή που χρησιμοποιείται για την έξοδο.

προεπιλογή 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: το πρόσημο καθορίζει την κατεύθυνση, προς τα πάνω για θετικές τιμές και προς τα κάτω για αρνητικές.

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

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

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

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

Προσαρμόζει το πρόσωπο σε μία φωτογραφία πορτρέτου χωρίς βίντεο καθοδήγησης. Τα ρυθμιστικά καλύπτουν ανοιγοκλείσιμο ματιών, φρύδια, κλείσιμο ενός ματιού, θέση κόρης, σχήματα στόματος (aaa, eee, woo), χαμόγελο και περιστροφή κεφαλής (pitch, yaw, roll). Οι επιλογές περικοπής, όπως `flag_do_crop` και `scale`, καθώς και το `dsize` (προεπιλογή 512), ελέγχουν την περικοπή προσώπου. Η έξοδος είναι jpeg από προεπιλογή ή png.

Παράμετροι

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

ΌνομαΤύπος ΠροεπιλογήΕπιτρεπόμενο Περιγραφή
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
Βαθμός χαμόγελου.
rotate_pitchπροαιρετικό
Τύποςnumber
Προεπιλογή0
-45 – 45
Ποσότητα περιστροφής του προσώπου κατά τον άξονα pitch.
rotate_yawπροαιρετικό
Τύποςnumber
Προεπιλογή0
-45 – 45
Ποσότητα περιστροφής του προσώπου κατά τον άξονα yaw.
rotate_rollπροαιρετικό
Τύποςnumber
Προεπιλογή0
-45 – 45
Ποσότητα περιστροφής του προσώπου κατά τον άξονα roll.
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.
flag_lip_zeroπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Κλείσιμο χειλιών πριν από το animation, εφαρμόσιμο μόνο όταν τα flag_eye_retargeting και flag_lip_retargeting έχουν οριστεί σε False.
dsizeπροαιρετικό
Τύποςinteger
Προεπιλογή512
Διαστάσεις της εικόνας που προκύπτει.
scaleπροαιρετικό
Τύποςnumber
Προεπιλογή2.3
Πολλαπλασιαστής κλίμακας που εφαρμόζεται στο face crop.
vx_ratioπροαιρετικό
Τύποςnumber
Προεπιλογή0
Αναλογία που ελέγχει την οριζόντια μετατόπιση του face crop.
vy_ratioπροαιρετικό
Τύποςnumber
Προεπιλογή-0.125
Αναλογία κατακόρυφης τοποθέτησης face-crop: το πρόσημο καθορίζει την κατεύθυνση, προς τα πάνω για θετικές τιμές και προς τα κάτω για αρνητικές.
enable_safety_checkerπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Ελέγχει αν είναι ενεργοποιημένος ο έλεγχος ασφάλειας. Όταν ενεργοποιείται, ο ελεγκτής επεξεργάζεται την εικόνα εισόδου για να επαληθεύσει ότι περιέχει πρόσωπο πριν από την επεξεργασία του μοντέλου.
output_formatπροαιρετικό
Τύποςenum
Προεπιλογήjpeg
jpegpng
Μορφή που χρησιμοποιείται για την έξοδο.
απαιτείται Κανονικό όνομα, επίσης αποδεκτό

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

Έξοδος

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

Περισσότερα μοντέλα: Επεξεργασία εικόνας

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