Skip to content

IP Adapter Face ID

Integrate

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

This request: ≈$0.06 60 API credits Run it on this page

Get API key
Tencent Image Editing #ip-adapter#personalization#customization#editing

Generates images that match a face from one photo or a zip of photos, on SD 1.5 or SDXL bases

Tencent · Image

Your first result goes here

Build a request below and run it with your API key. Outputs are copied to our storage, kept forever or 7 days for free.

Build a request

Controls are generated from the model schema. The code and the price update as you change them.

•required

Describe the image you want generated, using as much detail as possible to get the best results.

default 4

Sample count for face ID, defaulting to 4. Increasing the count improves image quality but lengthens generation time.

Advanced 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
default blurry, low resolutio...

Negative prompt specifying unwanted image details. It can exclude colors, objects, scenery, or finer features and qualities, such as a moustache, blur, or low resolution.

Drop a file, or

Face-matching reference image, scaled and cropped to 640x640 whenever its dimensions differ from that size.

model_type default 1_5-v1

Model selection, with 1_5 serving as both the default and the recommended choice for most uses.

Face-image zip archive URL, used to build a more accurate face ID by averaging embeddings from the archived images.

default SG161222/Realistic_Vi...

Base 1.5 model's URL; defaults to `SG161222/Realistic_Vision_V4.0_noVAE`.

default SG161222/RealVisXL_V3.0

Base SDXL model's URL; defaults to `SG161222/RealVisXL_V3.0`.

default 7.5

Prompt-adherence strength for image selection, expressed as CFG (Classifier Free Guidance).

default 50

Image-generation inference step count, with better image quality at larger counts at the expense of longer generation time.

default 512

Width of the resulting image.

default 512

Height of the resulting image.

default 640

Set the face detection model size, reducing it if the model cannot find a face in your image. A larger setting gives more accurate detection, but also runs more slowly and is more likely to miss a face entirely.

Seed for reproducing images in Stable Diffusion. An image can be reproduced exactly on every run by keeping the model version, prompt, and seed unchanged.

POST /run/ip-adapter-face-id?wait=20 quote → $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"

Run this request

Your key stays in this browser: it is sent only to the Doitong API and saved (localStorage) only if you tick Remember. Get an API key

About IP Adapter Face ID

Personalizes generation to a face given as `face_image_url`, or as a zip of several faces via `face_images_data_url` whose embeddings are averaged. `model_type` selects among SD 1.5 and SDXL variants, and the base checkpoints can be changed with repo parameters. `width` and `height` range from 512 to 1024, and `num_inference_steps` up to 200.

Parameters

NameType DefaultAllowed Description
model_typeoptional
Typeenum
Default1_5-v1
1_5-v11_5-v1-plus1_5-v2-plusSDXL-v1SDXL-v2-plus1_5-auraface-v1
Model selection, with 1_5 serving as both the default and the recommended choice for most uses.
promptrequired
Typestring
Describe the image you want generated, using as much detail as possible to get the best results.
face_image_urloptional
Typeurl · image
Face-matching reference image, scaled and cropped to 640x640 whenever its dimensions differ from that size.
face_images_data_urloptional
Typestring | null
Face-image zip archive URL, used to build a more accurate face ID by averaging embeddings from the archived images.
negative_promptoptional
Typestring
Defaultblurry, low resolution, bad, ugly, low quality, pixelated, interpolated, compression artifacts, noisey, grainy
Negative prompt specifying unwanted image details. It can exclude colors, objects, scenery, or finer features and qualities, such as a moustache, blur, or low resolution.
seedoptional
Typeinteger | null
Seed for reproducing images in Stable Diffusion. An image can be reproduced exactly on every run by keeping the model version, prompt, and seed unchanged.
guidance_scaleoptional
Typenumber
Default7.5
0 – 16
Prompt-adherence strength for image selection, expressed as CFG (Classifier Free Guidance).
num_inference_stepsoptional
Typeinteger
Default50
1 – 200
Image-generation inference step count, with better image quality at larger counts at the expense of longer generation time.
num_samplesoptional
Typeinteger
Default4
1 – 4
Sample count for face ID, defaulting to 4. Increasing the count improves image quality but lengthens generation time.
widthoptional
Typeinteger
Default512
512 – 1,024
Width of the resulting image.
heightoptional
Typeinteger
Default512
512 – 1,024
Height of the resulting image.
face_id_det_sizeoptional
Typeinteger
Default640
64 – 640
Set the face detection model size, reducing it if the model cannot find a face in your image. A larger setting gives more accurate detection, but also runs more slowly and is more likely to miss a face entirely.
base_1_5_model_repooptional
Typestring
DefaultSG161222/Realistic_Vision_V4.0_noVAE
Base 1.5 model's URL; defaults to `SG161222/Realistic_Vision_V4.0_noVAE`.
base_sdxl_model_repooptional
Typestring
DefaultSG161222/RealVisXL_V3.0
Base SDXL model's URL; defaults to `SG161222/RealVisXL_V3.0`.
enable_safety_checkeroptional
Typeboolean
Defaulttrue
Screening can be relaxed by setting false, provided the caller is authorized.
required

File parameters take a public https:// URL, a data: URI up to 10 MB, or the file_url of an upload. Files

Output

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"
  }
}
Your files, your choiceEvery outputs[].url is a copy on our storage: kept forever (paid per GB-month) or 7 days for free, by your account setting or ?storage=.
Same shape on every modeltype, url, content_type, width, height and duration, for images, video and audio alike. output is the model’s own result object.
Fields of output
image
object {url, content_type, file_name, file_size, width, height}File information for the generated image.
seed
integerImage-generation seed, including the randomly chosen value if the input omitted a seed; otherwise, it repeats the supplied value.

For AI agents: this page as Markdown is at https://doitong.com/developers/models/ip-adapter-face-id.md. All models and guides: https://doitong.com/developers/llms.txt