דילוג לתוכן

IP Adapter Face 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

בקשה זו: ≈⁨‏0.06 ‏$⁩ 60 קרדיטי API · ≈ ⁨‏6.33 ‏₽⁩ הרצה בדף הזה

קבלת מפתח API
Tencent עריכת תמונה #ip-adapter#personalization#customization#editing

מפיק תמונות התואמות לפנים מתמונה אחת או מקובץ zip של תמונות, על בסיסי SD 1.5 או SDXL

Tencent · תמונה

התוצאה הראשונה שלך תופיע כאן

בנו בקשה למטה והריצו אותה עם מפתח ה־API שלכם. הפלטים מועתקים לאחסון שלנו ונשמרים לצמיתות או למשך 7 ימים ללא תשלום.

בנה בקשה

הפקדים נוצרים מסכמת המודל. הקוד והמחיר מתעדכנים כשמשנים אותם.

•חובה

תאר את התמונה שברצונך ליצור, בפירוט רב ככל האפשר לקבלת התוצאות הטובות ביותר.

ברירת מחדל 4

מספר דגימות עבור מזהה פנים, שברירת המחדל שלו היא 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...

הנחיה שלילית המציינת פרטי תמונה לא רצויים. היא יכולה להחריג צבעים, אובייקטים, נוף או תכונות ואיכויות עדינות יותר, כגון שפם, טשטוש או רזולוציה נמוכה.

גרור קובץ, או

תמונת ייחוס להתאמת פנים, ששונתה ונחתכה ל-640x640 כאשר מידותיה שונות מגודל זה.

model_type ברירת מחדל 1_5-v1

בחירת מודל, כאשר 1_5 משמש גם כברירת המחדל וגם כאפשרות המומלצת לרוב השימושים.

כתובת URL של ארכיון zip של תמונות פנים, המשמשת לבניית מזהה פנים מדויק יותר באמצעות מיצוע ההטמעות מהתמונות שבארכיון.

ברירת מחדל SG161222/Realistic_Vi...

כתובת URL של מודל Base 1.5; ברירת המחדל היא `SG161222/Realistic_Vision_V4.0_noVAE`.

ברירת מחדל SG161222/RealVisXL_V3.0

כתובת URL של מודל Base SDXL; ברירת המחדל היא `SG161222/RealVisXL_V3.0`.

ברירת מחדל 7.5

עוצמת ההיצמדות להנחיה עבור בחירת תמונה, המבוטאת כ-CFG (Classifier Free Guidance).

ברירת מחדל 50

מספר שלבי ההסקה ליצירת תמונה, כאשר מספרים גבוהים יותר משפרים את איכות התמונה במחיר של זמן יצירה ארוך יותר.

ברירת מחדל 512

רוחב התמונה שהתקבלה.

ברירת מחדל 512

גובה התמונה שהתקבלה.

ברירת מחדל 640

הגדרת גודל מודל זיהוי הפנים, והקטנתו אם המודל אינו מוצא פנים בתמונה. הגדרה גדולה יותר מספקת זיהוי מדויק יותר, אך פועלת לאט יותר וסביר יותר שתפספס פנים לחלוטין.

זרע לשחזור תמונות ב־Stable Diffusion. ניתן לשחזר תמונה בדיוק בכל הרצה באמצעות שמירה על גרסת המודל, ההנחיה והזרע ללא שינוי.

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.ru/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.ru/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 של תמונות פנים, המשמשת לבניית מזהה פנים מדויק יותר באמצעות מיצוע ההטמעות מהתמונות שבארכיון.
negative_promptאופציונלי
סוגstring
ברירת מחדלblurry, low resolution, bad, ugly, low quality, pixelated, interpolated, compression artifacts, noisey, grainy
הנחיה שלילית המציינת פרטי תמונה לא רצויים. היא יכולה להחריג צבעים, אובייקטים, נוף או תכונות ואיכויות עדינות יותר, כגון שפם, טשטוש או רזולוציה נמוכה.
seedאופציונלי
סוגinteger | null
זרע לשחזור תמונות ב־Stable Diffusion. ניתן לשחזר תמונה בדיוק בכל הרצה באמצעות שמירה על גרסת המודל, ההנחיה והזרע ללא שינוי.
guidance_scaleאופציונלי
סוגnumber
ברירת מחדל7.5
0 – 16
עוצמת ההיצמדות להנחיה עבור בחירת תמונה, המבוטאת כ-CFG (Classifier Free Guidance).
num_inference_stepsאופציונלי
סוגinteger
ברירת מחדל50
1 – 200
מספר שלבי ההסקה ליצירת תמונה, כאשר מספרים גבוהים יותר משפרים את איכות התמונה במחיר של זמן יצירה ארוך יותר.
num_samplesאופציונלי
סוגinteger
ברירת מחדל4
1 – 4
מספר דגימות עבור מזהה פנים, שברירת המחדל שלו היא 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 של מודל Base 1.5; ברירת המחדל היא `SG161222/Realistic_Vision_V4.0_noVAE`.
base_sdxl_model_repoאופציונלי
סוגstring
ברירת מחדלSG161222/RealVisXL_V3.0
כתובת URL של מודל Base 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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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/he/developers/models/ip-adapter-face-id.md. כל המודלים והמדריכים: https://doitong.com/developers/llms.txt