رفتن به محتوا

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"

این درخواست: ≈⁨‎$۰٫۰۶⁩ ۶۰ اعتبار API اجرای آن در این صفحه

دریافت کلید API
Tencent ویرایش تصویر #ip-adapter#personalization#customization#editing

تصاویری هماهنگ با چهره یک عکس یا فایل zip عکس‌ها را بر پایه SD 1.5 یا SDXL تولید می‌کند

Tencent · تصویر

اولین نتیجه شما اینجا قرار می‌گیرد

درخواست را در زیر بسازید و با کلید API خود اجرا کنید. خروجی‌ها در فضای ذخیره‌سازی ما کپی می‌شوند و برای همیشه یا به‌مدت ۷ روز رایگان نگه‌داری می‌شوند.

ساخت درخواست

کنترل‌ها از شِمای مدل تولید می‌شوند. با تغییر آن‌ها، کد و قیمت به‌روزرسانی می‌شوند.

•الزامی

تصویری را که می‌خواهید تولید شود با بیشترین جزئیات ممکن توصیف کنید تا بهترین نتیجه به‌دست آید.

پیش‌فرض 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 هم مقدار پیش‌فرض و هم گزینه پیشنهادی برای بیشتر کاربردهاست.

نشانی اینترنتی بایگانی zip تصاویر چهره، برای ساخت شناسه چهره دقیق‌تر با میانگین‌گیری از embeddingهای تصاویر بایگانی‌شده.

پیش‌فرض SG161222/Realistic_Vi...

نشانی اینترنتی مدل پایه 1.5؛ مقدار پیش‌فرض `SG161222/Realistic_Vision_V4.0_noVAE` است.

پیش‌فرض SG161222/RealVisXL_V3.0

نشانی اینترنتی مدل پایه SDXL؛ مقدار پیش‌فرض `SG161222/RealVisXL_V3.0` است.

پیش‌فرض 7.5

میزان پایبندی به پرامپت برای انتخاب تصویر، بیان‌شده به‌صورت CFG (Classifier Free Guidance).

پیش‌فرض 50

تعداد گام‌های استنتاج تولید تصویر؛ مقادیر بیشتر کیفیت تصویر را بهبود می‌دهند اما زمان تولید را افزایش می‌دهند.

پیش‌فرض 512

عرض تصویر نهایی.

پیش‌فرض 512

ارتفاع تصویر نهایی.

پیش‌فرض 640

اندازه مدل تشخیص چهره را تنظیم کنید؛ اگر مدل نمی‌تواند چهره‌ای در تصویر شما پیدا کند، آن را کاهش دهید. مقدار بزرگ‌تر تشخیص دقیق‌تری می‌دهد، اما کندتر اجرا می‌شود و احتمال از دست‌دادن کامل چهره بیشتر است.

seed برای بازتولید تصاویر در Stable Diffusion. با ثابت نگه‌داشتن نسخه مدل، پرامپت و seed، تصویر می‌تواند در هر اجرا دقیقاً بازتولید شود.

POST /run/ip-adapter-face-id?wait=20 قیمت → ⁨‎$۰٫۰۶⁩
# 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` شخصی‌سازی می‌کند، یا چند چهره را از طریق `face_images_data_url` در قالب zip می‌گیرد و embeddingهای آن‌ها را میانگین‌گیری می‌کند. `model_type` گونه‌های SD 1.5 و SDXL را انتخاب می‌کند و checkpointهای پایه با پارامترهای 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
نشانی اینترنتی بایگانی zip تصاویر چهره، برای ساخت شناسه چهره دقیق‌تر با میانگین‌گیری از embeddingهای تصاویر بایگانی‌شده.
negative_promptاختیاری
نوعstring
پیش‌فرضblurry, low resolution, bad, ugly, low quality, pixelated, interpolated, compression artifacts, noisey, grainy
پرامپت منفی برای مشخص‌کردن جزئیات ناخواسته تصویر. می‌تواند رنگ‌ها، اشیا، مناظر یا ویژگی‌ها و کیفیت‌های ظریف‌تر مانند سبیل، تاری یا وضوح پایین را حذف کند.
seedاختیاری
نوعinteger | null
seed برای بازتولید تصاویر در Stable Diffusion. با ثابت نگه‌داشتن نسخه مدل، پرامپت و seed، تصویر می‌تواند در هر اجرا دقیقاً بازتولید شود.
guidance_scaleاختیاری
نوعnumber
پیش‌فرض7.5
۰ – ۱۶
میزان پایبندی به پرامپت برای انتخاب تصویر، بیان‌شده به‌صورت CFG (Classifier Free Guidance).
num_inference_stepsاختیاری
نوعinteger
پیش‌فرض50
۱ – ۲۰۰
تعداد گام‌های استنتاج تولید تصویر؛ مقادیر بیشتر کیفیت تصویر را بهبود می‌دهند اما زمان تولید را افزایش می‌دهند.
num_samplesاختیاری
نوعinteger
پیش‌فرض4
۱ – ۴
تعداد نمونه برای شناسه چهره، با مقدار پیش‌فرض 4. افزایش این تعداد کیفیت تصویر را بهتر، اما زمان تولید را طولانی‌تر می‌کند.
widthاختیاری
نوعinteger
پیش‌فرض512
۵۱۲ – ۱٬۰۲۴
عرض تصویر نهایی.
heightاختیاری
نوعinteger
پیش‌فرض512
۵۱۲ – ۱٬۰۲۴
ارتفاع تصویر نهایی.
face_id_det_sizeاختیاری
نوعinteger
پیش‌فرض640
۶۴ – ۶۴۰
اندازه مدل تشخیص چهره را تنظیم کنید؛ اگر مدل نمی‌تواند چهره‌ای در تصویر شما پیدا کند، آن را کاهش دهید. مقدار بزرگ‌تر تشخیص دقیق‌تری می‌دهد، اما کندتر اجرا می‌شود و احتمال از دست‌دادن کامل چهره بیشتر است.
base_1_5_model_repoاختیاری
نوعstring
پیش‌فرضSG161222/Realistic_Vision_V4.0_noVAE
نشانی اینترنتی مدل پایه 1.5؛ مقدار پیش‌فرض `SG161222/Realistic_Vision_V4.0_noVAE` است.
base_sdxl_model_repoاختیاری
نوعstring
پیش‌فرضSG161222/RealVisXL_V3.0
نشانی اینترنتی مدل پایه 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-ماه) یا به‌مدت ۷ روز رایگان، بر اساس تنظیم حساب شما یا ?storage=.
ساختار یکسان در همه مدل‌هاtype، url، content_type، width، height و duration برای تصاویر، ویدیو و صدا یکسان هستند. output شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
image
object {url, content_type, file_name, file_size, width, height}اطلاعات فایل تصویر تولیدشده.
seed
integerSeed تولید تصویر، شامل مقدار تصادفی انتخاب‌شده در صورت حذف Seed از ورودی؛ در غیر این صورت، مقدار ارائه‌شده را تکرار می‌کند.

برای عامل‌های هوش مصنوعی: این صفحه به‌صورت Markdown در دسترس است https://doitong.com/fa/developers/models/ip-adapter-face-id.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt