Siirry sisältöön

IP Adapter Face ID

Integroi

Mallin tunniste 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"

Tämä pyyntö: ≈0,06 $ 60 API-krediittiä Suorita tällä sivulla

Hanki API-avain
Tencent Kuvan muokkaus #ip-adapter#personalization#customization#editing

Luo kasvoja vastaavia kuvia yhdestä valokuvasta tai valokuvien zip-tiedostosta SD 1.5- tai SDXL-perustalle

Tencent · Kuva

Ensimmäinen tuloksesi tulee tähän

Muodosta pyyntö alla ja suorita se API-avaimellasi. Tulosteet kopioidaan tallennustilaamme, jossa ne säilytetään ikuisesti tai 7 päivää ilmaiseksi.

Muodosta pyyntö

Säätimet luodaan mallin skeemasta. Koodi ja hinta päivittyvät, kun muutat arvoja.

•pakollinen

Kuvaile haluamasi generoitava kuva mahdollisimman yksityiskohtaisesti parhaan tuloksen saamiseksi.

oletus 4

Kasvo-ID:n näytemäärä, oletuksena 4. Määrän kasvattaminen parantaa kuvan laatua mutta pidentää generointiaikaa.

Lisäasetukset 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
oletus blurry, low resolutio...

Negatiivinen kehote, joka määrittää ei-toivotut kuvan yksityiskohdat. Sillä voi sulkea pois värejä, objekteja, maisemia tai hienompia piirteitä ja ominaisuuksia, kuten viikset, sumennuksen tai matalan resoluution.

Pudota tiedosto tai

Kasvojen täsmäytyksen viitekuva, joka skaalataan ja rajataan kokoon 640x640, jos sen mitat poikkeavat tästä koosta.

model_type oletus 1_5-v1

Mallin valinta; 1_5 on sekä oletus että useimpiin käyttötarkoituksiin suositeltu valinta.

Kasvokuvien zip-arkiston URL, jota käytetään tarkemman kasvo-ID:n muodostamiseen keskiarvoistamalla arkiston kuvien upotukset.

oletus SG161222/Realistic_Vi...

Base 1.5 -mallin URL; oletus on `SG161222/Realistic_Vision_V4.0_noVAE`.

oletus SG161222/RealVisXL_V3.0

Base SDXL -mallin URL; oletus on `SG161222/RealVisXL_V3.0`.

oletus 7.5

Kuvan valinnan kehotteenmukaisuuden voimakkuus, ilmaistuna CFG:nä (Classifier Free Guidance).

oletus 50

Kuvageneroinnin päätelmävaiheiden määrä; suurempi määrä parantaa kuvan laatua mutta pidentää generointiaikaa.

oletus 512

Tuloksena saatavan kuvan leveys.

oletus 512

Tuloksena saatavan kuvan korkeus.

oletus 640

Aseta kasvojentunnistusmallin koko ja pienennä sitä, jos malli ei löydä kasvoja kuvasta. Suurempi asetus tuottaa tarkemman tunnistuksen, mutta toimii hitaammin ja todennäköisemmin ohittaa kasvot kokonaan.

Siemen kuvien toistamiseen Stable Diffusionissa. Kuva voidaan toistaa täsmälleen jokaisella suorituskerralla pitämällä malliversio, kehote ja siemen muuttumattomina.

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

Suorita tämä pyyntö

Avaimesi säilyy tässä selaimessa: se lähetetään vain Doitong APIlle ja tallennetaan localStorageen vain, jos valitset Muista. Hanki API-avain

Tietoja: IP Adapter Face ID

Personoi generoinnin `face_image_url`-parametrilla annetun kasvon tai useiden kasvojen zip-tiedoston perusteella parametrilla `face_images_data_url`, jonka upotukset keskiarvoistetaan. `model_type` valitsee SD 1.5- ja SDXL-versioiden välillä, ja perustarkistuspisteitä voi vaihtaa repo-parametreilla. `width` ja `height` ovat välillä 512–1024, ja `num_inference_steps` voi olla enintään 200.

Parametrit

NimiTyyppi OletusSallitut Kuvaus
model_typevalinnainen
Tyyppienum
Oletus1_5-v1
1_5-v11_5-v1-plus1_5-v2-plusSDXL-v1SDXL-v2-plus1_5-auraface-v1
Mallin valinta; 1_5 on sekä oletus että useimpiin käyttötarkoituksiin suositeltu valinta.
promptpakollinen
Tyyppistring
Kuvaile haluamasi generoitava kuva mahdollisimman yksityiskohtaisesti parhaan tuloksen saamiseksi.
face_image_urlvalinnainen
Tyyppiurl · image
Kasvojen täsmäytyksen viitekuva, joka skaalataan ja rajataan kokoon 640x640, jos sen mitat poikkeavat tästä koosta.
face_images_data_urlvalinnainen
Tyyppistring | null
Kasvokuvien zip-arkiston URL, jota käytetään tarkemman kasvo-ID:n muodostamiseen keskiarvoistamalla arkiston kuvien upotukset.
negative_promptvalinnainen
Tyyppistring
Oletusblurry, low resolution, bad, ugly, low quality, pixelated, interpolated, compression artifacts, noisey, grainy
Negatiivinen kehote, joka määrittää ei-toivotut kuvan yksityiskohdat. Sillä voi sulkea pois värejä, objekteja, maisemia tai hienompia piirteitä ja ominaisuuksia, kuten viikset, sumennuksen tai matalan resoluution.
seedvalinnainen
Tyyppiinteger | null
Siemen kuvien toistamiseen Stable Diffusionissa. Kuva voidaan toistaa täsmälleen jokaisella suorituskerralla pitämällä malliversio, kehote ja siemen muuttumattomina.
guidance_scalevalinnainen
Tyyppinumber
Oletus7.5
0 – 16
Kuvan valinnan kehotteenmukaisuuden voimakkuus, ilmaistuna CFG:nä (Classifier Free Guidance).
num_inference_stepsvalinnainen
Tyyppiinteger
Oletus50
1 – 200
Kuvageneroinnin päätelmävaiheiden määrä; suurempi määrä parantaa kuvan laatua mutta pidentää generointiaikaa.
num_samplesvalinnainen
Tyyppiinteger
Oletus4
1 – 4
Kasvo-ID:n näytemäärä, oletuksena 4. Määrän kasvattaminen parantaa kuvan laatua mutta pidentää generointiaikaa.
widthvalinnainen
Tyyppiinteger
Oletus512
512 – 1 024
Tuloksena saatavan kuvan leveys.
heightvalinnainen
Tyyppiinteger
Oletus512
512 – 1 024
Tuloksena saatavan kuvan korkeus.
face_id_det_sizevalinnainen
Tyyppiinteger
Oletus640
64 – 640
Aseta kasvojentunnistusmallin koko ja pienennä sitä, jos malli ei löydä kasvoja kuvasta. Suurempi asetus tuottaa tarkemman tunnistuksen, mutta toimii hitaammin ja todennäköisemmin ohittaa kasvot kokonaan.
base_1_5_model_repovalinnainen
Tyyppistring
OletusSG161222/Realistic_Vision_V4.0_noVAE
Base 1.5 -mallin URL; oletus on `SG161222/Realistic_Vision_V4.0_noVAE`.
base_sdxl_model_repovalinnainen
Tyyppistring
OletusSG161222/RealVisXL_V3.0
Base SDXL -mallin URL; oletus on `SG161222/RealVisXL_V3.0`.
enable_safety_checkervalinnainen
Tyyppiboolean
Oletustrue
Suodatusta voi höllentää asettamalla arvoksi false, jos kutsujalla on siihen valtuutus.
pakollinen

Tiedostoparametrit hyväksyvät julkisen https://-URL:n, enintään 10 MB:n data:-URI:n tai lähetyksen file_url-arvon. Tiedostot

Tulos

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"
  }
}
Tiedostosi, valintasiJokainen outputs[].url on kopio tallennustilassamme: säilytetään ikuisesti (maksetaan gigatavu-kuukauden mukaan) tai 7 päivää ilmaiseksi tiliasetuksesi tai ?storage= perusteella.
Sama rakenne kaikissa malleissatype, url, content_type, width, height ja duration kuville, videolle ja äänelle. output on mallin oma tulosobjekti.
Tuloksen kentät
image
object {url, content_type, file_name, file_size, width, height}Generoidun kuvan tiedot.
seed
integerKuvageneroinnin siemen, mukaan lukien satunnaisesti valittu arvo, jos syötteessä ei annettu siementä; muuten annettu arvo toistetaan.

Tekoälyagenteille: tämän sivun Markdown-muoto on osoitteessa https://doitong.com/fi/developers/models/ip-adapter-face-id.md. Kaikki mallit ja oppaat: https://doitong.com/developers/llms.txt