שפּרינגען צו אינהאַלט

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

נעגאַטיווער פּראָמפּט וואָס ספּעציפֿיצירט אומגעוווּנטשן בילד־דעטאַל. ער קען אויסשליסן קאָלירן, אָביעקטן, לאַנדשאַפֿט אָדער קלענערע פֿעיִקייטן און קוואַליטעטן, ווי וואָנצעס, בלער אָדער נידעריקע רעזאָלוציע.

לייגט אַרײַן אַ טעקע, אָדער

רעפֿערענץ־בילד פֿאַר פּנים־מאַטשינג, געשקיילט און געקראפּט צו 640x640 ווען די דימענסיעס זענען אַנדערש.

model_type סטאַנדאַרט 1_5-v1

מאָדעל־אויסקלײַב, וווּ 1_5 איז סײַ דער סטאַנדאַרט סײַ די רעקאָמענדירטע ברירה פֿאַר רובֿ ניצונגען.

URL פון אַ ZIP־אַרכיוו מיט פּנים־בילדער, גענוצט צו בויען אַ מער פּינקטלעכן face ID דורך דורכשניט פון עמבעדינגס.

סטאַנדאַרט 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.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"

לויפֿן דעם ריקוועסט

אײַער 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־אַרכיוו מיט פּנים־בילדער, גענוצט צו בויען אַ מער פּינקטלעכן face ID דורך דורכשניט פון עמבעדינגס.
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
סאַמפּל־צאָל פֿאַר 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 פון 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, אויב דער רופער איז אָטעריזירט.
פארלאנגט

טעקע־פּאַראַמעטערס נעמען אַן עפֿנטלעכע https:// URL, אַ data: URI ביז 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
integerבילד־גענערירונג־סיד, אַרײַנגערעכנט דעם ראַנדאָם אויסגעקליבענעם ווערט אויב די אַרײַנגעבונג האט נישט אַרײַנגעגעבן קיין סיד; אַנדערש איבערחזרט עס דעם צוגעשטעלטן ווערט.

פֿאַר AI־אַגענטן: דער בלאַט ווי Markdown געפֿינט זיך בײַ https://doitong.com/yi/developers/models/ip-adapter-face-id.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt