Saltar al cuntegna

IP Adapter Face ID

Integrar

ID dal model 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"

Questa dumonda: ≈$0,06 60 credits API Lantschar sin questa pagina

Obtegna ina clav API
Tencent Modificaziun da maletgs #ip-adapter#personalization#customization#editing

Generescha maletgs che correspundan ad ina fatscha d’ina fotografia u d’in zip da fotografias, sin basas SD 1.5 u SDXL

Tencent · Maletg

Tes emprim resultat vegn qua

Construis ina dumonda sutvart e l'exequescha cun tia clav API. Outputs vegnan copiads en nossa memorisaziun, conservads per adina u 7 dis gratuitamain.

Construir ina dumonda

Ils controls vegnan generads dal schema dal model. Il code e ​​il pretsch s'actualiseschan durant che ti als midas.

•obligatori

Descriva il maletg che ti vuls generar, cun uschè blers detagls sco pussaivel per ils megliers resultats.

standard 4

Dumber da samples per l'ID da fatscha, cun il standard 4. Augmentar il dumber meglierescha la qualitad da la maletg, dentant prolungescha il temp da generaziun.

Avanzà 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
standard blurry, low resolutio...

Prompt negativ che specifica detagls da maletg betg giavischads. El po excluder colurs, objects, cuntradas u caracteristicas e qualitads pli finas, sco ina mustazza, sfuschadad u ina resoluziun bassa.

Trametta in datoteca u

Maletg da referenza per la cumparegliaziun da fatscha, scalà e retaglià a 640x640, schas dimensiuns differeschan.

model_type standard 1_5-v1

Selecziun dal model, cun 1_5 sco standard e scelta recumandada per la gronda part dals diever.

URL da l'archiv ZIP da maletgs da fatscha, utilisà per crear in ID da fatscha pli precis tras la media d'embeddings dals maletgs archivads.

standard SG161222/Realistic_Vi...

URL dal model da basa 1.5; il standard è `SG161222/Realistic_Vision_V4.0_noVAE`.

standard SG161222/RealVisXL_V3.0

URL dal model da basa SDXL; il standard è `SG161222/RealVisXL_V3.0`.

standard 7.5

Furza d'aderenza al prompt per la selecziun dal maletg, exprimida sco CFG (Classifier Free Guidance).

standard 50

Dumber da pass d'inferenza per la generaziun dal maletg; dumbers pli gronds megliereschan la qualitad dal maletg, ma augmentan il temp da generaziun.

standard 512

Ladezza da la maletg resultada.

standard 512

Autezza da la maletg resultada.

standard 640

Definescha la grondezza dal model da detecziun da fatschas, e reducescha ella, sche il model na chatta nagina fatscha en tia maletg. Ina configuraziun pli gronda dat ina detecziun pli precisa, dentant funcziuna pli plaun e na chatta pli savens nagina fatscha.

Seed per reproducir maletgs en Stable Diffusion. In maletg po vegnir reproducì exactamain en mintga execuziun sche la versiun dal model, il prompt ed il seed restan invariads.

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

Executar questa dumonda

Tia clav resta en quest browser: ella vegn tramessa mo al Doitong API e memorisada (localStorage) mo sch'ella scheccas Tiar a memoria. Obtegnair ina clav API

Davart IP Adapter Face ID

Persunalisescha la generaziun per ina fatscha furnida sco `face_image_url`, u sco zip da pliras fatschas via `face_images_data_url`, da las qualas las embeddings vegnan mediàdas. `model_type` tscherna tranter variantas SD 1.5 e SDXL, e las basas da checkpoints pon vegnir midadas cun parameters dal repo. `width` e `height` varieschan da 512 to 1024, e `num_inference_steps` va fin a 200.

Parameters

NumTip StandardPermess Descripziun
model_typeopziunal
Tipenum
Standard1_5-v1
1_5-v11_5-v1-plus1_5-v2-plusSDXL-v1SDXL-v2-plus1_5-auraface-v1
Selecziun dal model, cun 1_5 sco standard e scelta recumandada per la gronda part dals diever.
promptobligatori
Tipstring
Descriva il maletg che ti vuls generar, cun uschè blers detagls sco pussaivel per ils megliers resultats.
face_image_urlopziunal
Tipurl · image
Maletg da referenza per la cumparegliaziun da fatscha, scalà e retaglià a 640x640, schas dimensiuns differeschan.
face_images_data_urlopziunal
Tipstring | null
URL da l'archiv ZIP da maletgs da fatscha, utilisà per crear in ID da fatscha pli precis tras la media d'embeddings dals maletgs archivads.
negative_promptopziunal
Tipstring
Standardblurry, low resolution, bad, ugly, low quality, pixelated, interpolated, compression artifacts, noisey, grainy
Prompt negativ che specifica detagls da maletg betg giavischads. El po excluder colurs, objects, cuntradas u caracteristicas e qualitads pli finas, sco ina mustazza, sfuschadad u ina resoluziun bassa.
seedopziunal
Tipinteger | null
Seed per reproducir maletgs en Stable Diffusion. In maletg po vegnir reproducì exactamain en mintga execuziun sche la versiun dal model, il prompt ed il seed restan invariads.
guidance_scaleopziunal
Tipnumber
Standard7.5
0 – 16
Furza d'aderenza al prompt per la selecziun dal maletg, exprimida sco CFG (Classifier Free Guidance).
num_inference_stepsopziunal
Tipinteger
Standard50
1 – 200
Dumber da pass d'inferenza per la generaziun dal maletg; dumbers pli gronds megliereschan la qualitad dal maletg, ma augmentan il temp da generaziun.
num_samplesopziunal
Tipinteger
Standard4
1 – 4
Dumber da samples per l'ID da fatscha, cun il standard 4. Augmentar il dumber meglierescha la qualitad da la maletg, dentant prolungescha il temp da generaziun.
widthopziunal
Tipinteger
Standard512
512 – 1 024
Ladezza da la maletg resultada.
heightopziunal
Tipinteger
Standard512
512 – 1 024
Autezza da la maletg resultada.
face_id_det_sizeopziunal
Tipinteger
Standard640
64 – 640
Definescha la grondezza dal model da detecziun da fatschas, e reducescha ella, sche il model na chatta nagina fatscha en tia maletg. Ina configuraziun pli gronda dat ina detecziun pli precisa, dentant funcziuna pli plaun e na chatta pli savens nagina fatscha.
base_1_5_model_repoopziunal
Tipstring
StandardSG161222/Realistic_Vision_V4.0_noVAE
URL dal model da basa 1.5; il standard è `SG161222/Realistic_Vision_V4.0_noVAE`.
base_sdxl_model_repoopziunal
Tipstring
StandardSG161222/RealVisXL_V3.0
URL dal model da basa SDXL; il standard è `SG161222/RealVisXL_V3.0`.
enable_safety_checkeropziunal
Tipboolean
Standardtrue
La controlla po vegnir schluccada cun definir false, premess che l'appelant saja autorisà.
obligatori

Ils parameters da datotecas acceptan ina URL publica https://, ina URI data: fin a 10 MB u il file_url d'ina chargiada. Datotecas

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"
  }
}
Tias datotecas, tia decisiunMintga outputs[].url è ina copia en nossa memorisaziun: conservada per adina (pajà per GB-mes) u 7 dis gratuitamain, tenor la configuraziun dal conto u ?storage=.
La medema structura per mintga modeltype, url, content_type, width, height e duration, tant per maletgs sco per video e audio. output è l'object da resultat dal model sez.
Champs da l'output
image
object {url, content_type, file_name, file_size, width, height}Infurmaziuns davart la datoteca dal maletg generà.
seed
integerSeed da la generaziun dal maletg, inclusa la valur tschernida casualmain sche l'input n'ha betg furnì in seed; autramain repeta la valur furnida.

Per agents AI: questa pagina sco Markdown è disponibla sut https://doitong.com/rm/developers/models/ip-adapter-face-id.md. Tut ils models e las guidas: https://doitong.com/developers/llms.txt