تخطّي إلى المحتوى

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

عدد عينات معرّف الوجه، وقيمته الافتراضية 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 للنموذج الأساسي 1.5؛ القيمة الافتراضية هي `SG161222/Realistic_Vision_V4.0_noVAE`.

الافتراضي SG161222/RealVisXL_V3.0

عنوان URL لنموذج 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.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، ويمكن تغيير نقاط التحقق الأساسية باستخدام معاملات المستودع. تتراوح `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 للنموذج الأساسي 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 هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?storage=.
البنية نفسها في كل نموذجtype وurl وcontent_type وwidth وheight وduration للصور والفيديو والصوت على حد سواء. output هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
image
object {url, content_type, file_name, file_size, width, height}معلومات ملف الصورة المولدة.
seed
integerبذرة توليد الصورة، بما في ذلك القيمة المختارة عشوائيًا إذا لم يتضمن المدخل بذرة؛ وإلا تكرر القيمة المقدمة.

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/ip-adapter-face-id.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt