Мазмұнға өту

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

Бет 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 — әдепкі және көп жағдайда ұсынылатын таңдау.

Мұрағатталған кескіндердегі эмбеддингтерді орташалау арқылы дәлірек бет ID жасауға пайдаланылатын бет кескіндерінің zip архиві URL-і.

әдепкі SG161222/Realistic_Vi...

Base 1.5 моделінің URL-і; әдепкісі `SG161222/Realistic_Vision_V4.0_noVAE`.

әдепкі SG161222/RealVisXL_V3.0

Base SDXL моделінің URL-і; әдепкісі `SG161222/RealVisXL_V3.0`.

әдепкі 7.5

Кескін таңдау кезіндегі нұсқауға сәйкестік күші CFG (Classifier Free Guidance) ретінде көрсетіледі.

әдепкі 50

Кескін генерациясының инференс қадамдары саны; сан артқан сайын кескін сапасы жақсарады, бірақ генерация уақыты ұзарады.

әдепкі 512

Нәтижелік кескіннің ені.

әдепкі 512

Нәтижелік кескіннің биіктігі.

әдепкі 640

Бет анықтау моделінің өлшемін орнатыңыз; модель кескініңізден бет таба алмаса, оны азайтыңыз. Үлкен мән дәлірек анықтайды, бірақ баяуырақ жұмыс істейді және бетті мүлде өткізіп алу ықтималдығы жоғары.

Stable Diffusion кескіндерін қайталауға арналған seed. Модель нұсқасын, нұсқауды және seed мәнін өзгеріссіз сақтау арқылы кескінді әр іске қосқанда дәл қайталауға болады.

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-ге жіберіледі және Remember параметрін белгілеcеңіз ғана localStorage ішінде сақталады. API кілтін алу

IP Adapter Face ID туралы

Генерацияны `face_image_url` арқылы берілген бетке немесе `face_images_data_url` арқылы берілген бірнеше беттің zip мұрағатына бейімдейді; бірнеше беттің эмбеддингтері орташаланады. `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
Мұрағатталған кескіндердегі эмбеддингтерді орташалау арқылы дәлірек бет ID жасауға пайдаланылатын бет кескіндерінің zip архиві URL-і.
negative_promptміндетті емес
Түріstring
Әдепкіblurry, low resolution, bad, ugly, low quality, pixelated, interpolated, compression artifacts, noisey, grainy
Қалаусыз кескін мәліметтерін көрсететін теріс нұсқау. Ол түстерді, нысандарды, көріністерді немесе мұрт, бұлыңғырлық не төмен ажыратымдылық сияқты ұсақ белгілер мен қасиеттерді алып тастай алады.
seedміндетті емес
Түріinteger | null
Stable Diffusion кескіндерін қайталауға арналған seed. Модель нұсқасын, нұсқауды және seed мәнін өзгеріссіз сақтау арқылы кескінді әр іске қосқанда дәл қайталауға болады.
guidance_scaleміндетті емес
Түріnumber
Әдепкі7.5
0 – 16
Кескін таңдау кезіндегі нұсқауға сәйкестік күші CFG (Classifier Free Guidance) ретінде көрсетіледі.
num_inference_stepsміндетті емес
Түріinteger
Әдепкі50
1 – 200
Кескін генерациясының инференс қадамдары саны; сан артқан сайын кескін сапасы жақсарады, бірақ генерация уақыты ұзарады.
num_samplesміндетті емес
Түріinteger
Әдепкі4
1 – 4
Бет 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
Base 1.5 моделінің URL-і; әдепкісі `SG161222/Realistic_Vision_V4.0_noVAE`.
base_sdxl_model_repoміндетті емес
Түріstring
ӘдепкіSG161222/RealVisXL_V3.0
Base SDXL моделінің URL-і; әдепкісі `SG161222/RealVisXL_V3.0`.
enable_safety_checkerміндетті емес
Түріboolean
Әдепкіtrue
Шақырушы авторизацияланған болса, false мәнін орнату арқылы тексеруді жеңілдетуге болады.
міндетті

Файл параметрлері жалпыға қолжетімді https:// URL мекенжайын, 10 MB-қа дейінгі data: URI мекенжайын немесе жүктеп салынған файлдың 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= арқылы 7 күн тегін сақталады.
Әр модельдегі пішім бірдейtype, url, content_type, width, height және duration — кескіндерге, бейнеге және аудиоға ортақ. output — модельдің өз нәтижелер нысаны.
Шығыс өрістері
image
object {url, content_type, file_name, file_size, width, height}Генерацияланған кескін туралы файл ақпараты.
seed
integerКескін генерациясының seed мәні: кірісте seed көрсетілмесе, кездейсоқ таңдалған мәнді қамтиды; әйтпесе берілген мәнді қайталайды.

AI агенттеріне: бұл беттің Markdown нұсқасы мына жерде: https://doitong.com/kk/developers/models/ip-adapter-face-id.md. Барлық модельдер мен нұсқаулықтар: https://doitong.com/developers/llms.txt