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

IP Adapter Face ID

Ενσωμάτωση

id μοντέλου ip-adapter-face-id
# 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/ip-adapter-face-id?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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"

Αυτό το αίτημα: ≈0,06 $ 60 πιστώσεις API Εκτέλεση σε αυτήν τη σελίδα

Λήψη κλειδιού API
Tencent Επεξεργασία εικόνας #ip-adapter#personalization#customization#editing

Παράγει εικόνες που ταιριάζουν σε ένα πρόσωπο από μία φωτογραφία ή zip φωτογραφιών, με βάσεις SD 1.5 ή SDXL

Tencent · Εικόνα

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

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

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

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

•απαιτείται

Περιγράψτε την εικόνα που θέλετε να παραχθεί, με όσο το δυνατόν περισσότερες λεπτομέρειες για τα καλύτερα αποτελέσματα.

προεπιλογή 4

Πλήθος δειγμάτων για face ID, με προεπιλογή 4. Η αύξηση του πλήθους βελτιώνει την ποιότητα της εικόνας αλλά επιμηκύνει τον χρόνο παραγωγής.

Για προχωρημένους negative_prompt · face_image_url · model_type · face_images_data_url · base_1_5_model_repo · base_sdxl_model_repo · guidance_scale · num_inference_steps · width · height · face_id_det_size · seed · enable_safety_checker
προεπιλογή blurry, low resolutio...

Αρνητικό prompt που καθορίζει ανεπιθύμητες λεπτομέρειες εικόνας. Μπορεί να αποκλείσει χρώματα, αντικείμενα, τοπία ή λεπτότερα χαρακτηριστικά και ιδιότητες, όπως μουστάκι, θόλωση ή χαμηλή ανάλυση.

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

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

model_type προεπιλογή 1_5-v1

Επιλογή μοντέλου, όπου το 1_5 είναι τόσο η προεπιλεγμένη όσο και η συνιστώμενη επιλογή για τις περισσότερες χρήσεις.

URL αρχείου zip με εικόνες προσώπων, που χρησιμοποιείται για τη δημιουργία ακριβέστερου face ID μέσω υπολογισμού μέσου όρου των embeddings από τις αρχειοθετημένες εικόνες.

προεπιλογή SG161222/Realistic_Vi...

URL του βασικού μοντέλου 1.5· η προεπιλογή είναι `SG161222/Realistic_Vision_V4.0_noVAE`.

προεπιλογή SG161222/RealVisXL_V3.0

URL του βασικού μοντέλου SDXL· η προεπιλογή είναι `SG161222/RealVisXL_V3.0`.

προεπιλογή 7.5

Ισχύς προσήλωσης στο prompt για την επιλογή εικόνας, εκφρασμένη ως CFG (Classifier Free Guidance).

προεπιλογή 50

Πλήθος βημάτων inference για παραγωγή εικόνας, με καλύτερη ποιότητα εικόνας σε μεγαλύτερα πλήθη, εις βάρος μεγαλύτερου χρόνου παραγωγής.

προεπιλογή 512

Πλάτος της τελικής εικόνας.

προεπιλογή 512

Ύψος της τελικής εικόνας.

προεπιλογή 640

Ορίστε το μέγεθος του μοντέλου ανίχνευσης προσώπου, μειώνοντάς το αν το μοντέλο δεν μπορεί να βρει πρόσωπο στην εικόνα σας. Μεγαλύτερη ρύθμιση παρέχει ακριβέστερη ανίχνευση, αλλά εκτελείται πιο αργά και είναι πιθανότερο να μην εντοπίσει καθόλου ένα πρόσωπο.

Seed για αναπαραγωγή εικόνων στο Stable Diffusion. Μια εικόνα μπορεί να αναπαραχθεί ακριβώς σε κάθε εκτέλεση, αν παραμείνουν αμετάβλητα η έκδοση του μοντέλου, το prompt και το seed.

POST /run/ip-adapter-face-id?wait=20 προσφορά → 0,06 $
# 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/ip-adapter-face-id?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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

Σχετικά με το IP Adapter Face ID

Προσαρμόζει την παραγωγή σε πρόσωπο που δίνεται ως `face_image_url` ή ως zip πολλών προσώπων μέσω `face_images_data_url`, των οποίων οι ενσωματώσεις υπολογίζονται κατά μέσο όρο. Το `model_type` επιλέγει μεταξύ παραλλαγών SD 1.5 και SDXL, ενώ τα βασικά σημεία ελέγχου μπορούν να αλλάξουν με παραμέτρους repo. Τα `width` και `height` κυμαίνονται από 512 έως 1024 και το `num_inference_steps` φτάνει έως 200.

Παράμετροι

ΌνομαΤύπος ΠροεπιλογήΕπιτρεπόμενο Περιγραφή
model_typeπροαιρετικό
Τύποςenum
Προεπιλογή1_5-v1
1_5-v11_5-v1-plus1_5-v2-plusSDXL-v1SDXL-v2-plus1_5-auraface-v1
Επιλογή μοντέλου, όπου το 1_5 είναι τόσο η προεπιλεγμένη όσο και η συνιστώμενη επιλογή για τις περισσότερες χρήσεις.
promptαπαιτείται
Τύποςstring
Περιγράψτε την εικόνα που θέλετε να παραχθεί, με όσο το δυνατόν περισσότερες λεπτομέρειες για τα καλύτερα αποτελέσματα.
face_image_urlπροαιρετικό
Τύποςurl · image
Εικόνα αναφοράς για αντιστοίχιση προσώπου, με αλλαγή κλίμακας και περικοπή σε 640x640 όποτε οι διαστάσεις της διαφέρουν από αυτό το μέγεθος.
face_images_data_urlπροαιρετικό
Τύποςstring | null
URL αρχείου zip με εικόνες προσώπων, που χρησιμοποιείται για τη δημιουργία ακριβέστερου face ID μέσω υπολογισμού μέσου όρου των embeddings από τις αρχειοθετημένες εικόνες.
negative_promptπροαιρετικό
Τύποςstring
Προεπιλογήblurry, low resolution, bad, ugly, low quality, pixelated, interpolated, compression artifacts, noisey, grainy
Αρνητικό prompt που καθορίζει ανεπιθύμητες λεπτομέρειες εικόνας. Μπορεί να αποκλείσει χρώματα, αντικείμενα, τοπία ή λεπτότερα χαρακτηριστικά και ιδιότητες, όπως μουστάκι, θόλωση ή χαμηλή ανάλυση.
seedπροαιρετικό
Τύποςinteger | null
Seed για αναπαραγωγή εικόνων στο Stable Diffusion. Μια εικόνα μπορεί να αναπαραχθεί ακριβώς σε κάθε εκτέλεση, αν παραμείνουν αμετάβλητα η έκδοση του μοντέλου, το prompt και το seed.
guidance_scaleπροαιρετικό
Τύποςnumber
Προεπιλογή7.5
0 – 16
Ισχύς προσήλωσης στο prompt για την επιλογή εικόνας, εκφρασμένη ως CFG (Classifier Free Guidance).
num_inference_stepsπροαιρετικό
Τύποςinteger
Προεπιλογή50
1 – 200
Πλήθος βημάτων inference για παραγωγή εικόνας, με καλύτερη ποιότητα εικόνας σε μεγαλύτερα πλήθη, εις βάρος μεγαλύτερου χρόνου παραγωγής.
num_samplesπροαιρετικό
Τύποςinteger
Προεπιλογή4
1 – 4
Πλήθος δειγμάτων για face ID, με προεπιλογή 4. Η αύξηση του πλήθους βελτιώνει την ποιότητα της εικόνας αλλά επιμηκύνει τον χρόνο παραγωγής.
widthπροαιρετικό
Τύποςinteger
Προεπιλογή512
512 – 1.024
Πλάτος της τελικής εικόνας.
heightπροαιρετικό
Τύποςinteger
Προεπιλογή512
512 – 1.024
Ύψος της τελικής εικόνας.
face_id_det_sizeπροαιρετικό
Τύποςinteger
Προεπιλογή640
64 – 640
Ορίστε το μέγεθος του μοντέλου ανίχνευσης προσώπου, μειώνοντάς το αν το μοντέλο δεν μπορεί να βρει πρόσωπο στην εικόνα σας. Μεγαλύτερη ρύθμιση παρέχει ακριβέστερη ανίχνευση, αλλά εκτελείται πιο αργά και είναι πιθανότερο να μην εντοπίσει καθόλου ένα πρόσωπο.
base_1_5_model_repoπροαιρετικό
Τύποςstring
ΠροεπιλογήSG161222/Realistic_Vision_V4.0_noVAE
URL του βασικού μοντέλου 1.5· η προεπιλογή είναι `SG161222/Realistic_Vision_V4.0_noVAE`.
base_sdxl_model_repoπροαιρετικό
Τύποςstring
ΠροεπιλογήSG161222/RealVisXL_V3.0
URL του βασικού μοντέλου SDXL· η προεπιλογή είναι `SG161222/RealVisXL_V3.0`.
enable_safety_checkerπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Ο έλεγχος μπορεί να χαλαρώσει με τη ρύθμιση false, εφόσον ο καλών είναι εξουσιοδοτημένος.
απαιτείται

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

Έξοδος

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ip-adapter-face-id",
  "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": 60,
    "usd": "0.06",
    "charged": 60,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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
    },
    "seed": 42
  },
  "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}Πληροφορίες αρχείου για την παραγόμενη εικόνα.
seed
integerSeed παραγωγής εικόνας, συμπεριλαμβανομένης της τυχαία επιλεγμένης τιμής αν η είσοδος δεν περιείχε seed· διαφορετικά, επαναλαμβάνει την παρεχόμενη τιμή.

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