Vai al contenuto

IP Adapter Face ID

Integra

ID del modello 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 richiesta: ≈0,06 $ 60 crediti API Esegui in questa pagina

Ottieni la chiave API
Tencent Modifica immagini #ip-adapter#personalization#customization#editing

Genera immagini che corrispondono a un volto da una foto o da un archivio zip di foto, su modelli base SD 1.5 o SDXL

Tencent · Immagine

Il tuo primo risultato apparirà qui

Crea una richiesta qui sotto ed eseguila con la tua chiave API. Gli output vengono copiati nella nostra archiviazione, conservati per sempre oppure 7 giorni gratuitamente.

Crea una richiesta

I controlli vengono generati dallo schema del modello. Il codice e il prezzo si aggiornano mentre li modifichi.

•obbligatorio

Descrivi l'immagine che vuoi generare, usando più dettagli possibile per ottenere i risultati migliori.

predefinito 4

Numero di campioni per il face ID, con valore predefinito 4. Aumentare il numero migliora la qualità dell'immagine, ma allunga il tempo di generazione.

Avanzate 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
predefinito blurry, low resolutio...

Prompt negativo che specifica i dettagli indesiderati dell'immagine. Può escludere colori, oggetti, scenari o caratteristiche e qualità più fini, come baffi, sfocatura o bassa risoluzione.

Trascina un file oppure

Immagine di riferimento per la corrispondenza del volto, ridimensionata e ritagliata a 640x640 quando le sue dimensioni differiscono da quel formato.

model_type predefinito 1_5-v1

Selezione del modello, con 1_5 come valore predefinito e scelta consigliata per la maggior parte degli usi.

URL dell'archivio zip delle immagini del volto, utilizzato per creare un face ID più accurato calcolando la media degli embedding delle immagini archiviate.

predefinito SG161222/Realistic_Vi...

URL del modello Base 1.5; il valore predefinito è `SG161222/Realistic_Vision_V4.0_noVAE`.

predefinito SG161222/RealVisXL_V3.0

URL del modello Base SDXL; il valore predefinito è `SG161222/RealVisXL_V3.0`.

predefinito 7.5

Intensità di aderenza al prompt per la selezione dell'immagine, espressa come CFG (Classifier Free Guidance).

predefinito 50

Numero di passaggi di inferenza per la generazione dell'immagine; valori più elevati migliorano la qualità dell'immagine a fronte di un tempo di generazione maggiore.

predefinito 512

Larghezza dell'immagine risultante.

predefinito 512

Altezza dell'immagine risultante.

predefinito 640

Imposta la dimensione del modello di rilevamento del volto, riducendola se il modello non riesce a trovare un volto nell'immagine. Un'impostazione maggiore offre un rilevamento più accurato, ma è anche più lenta e ha maggiori probabilità di non rilevare affatto un volto.

Seed per riprodurre immagini in Stable Diffusion. Un'immagine può essere riprodotta esattamente a ogni esecuzione mantenendo invariati la versione del modello, il prompt e il seed.

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

Esegui questa richiesta

La tua chiave rimane in questo browser: viene inviata solo al Doitong API e salvata in localStorage solo se selezioni Ricorda. Ottieni una chiave API

Informazioni su IP Adapter Face ID

Personalizza la generazione in base a un volto fornito come `face_image_url` o come zip di più volti tramite `face_images_data_url`, i cui embedding vengono mediati. `model_type` seleziona tra le varianti SD 1.5 e SDXL e i checkpoint di base possono essere modificati con i parametri del repository. `width` e `height` variano da 512 a 1024 e `num_inference_steps` arriva fino a 200.

Parametri

NomeTipo PredefinitoConsentiti Descrizione
model_typefacoltativo
Tipoenum
Predefinito1_5-v1
1_5-v11_5-v1-plus1_5-v2-plusSDXL-v1SDXL-v2-plus1_5-auraface-v1
Selezione del modello, con 1_5 come valore predefinito e scelta consigliata per la maggior parte degli usi.
promptobbligatorio
Tipostring
Descrivi l'immagine che vuoi generare, usando più dettagli possibile per ottenere i risultati migliori.
face_image_urlfacoltativo
Tipourl · image
Immagine di riferimento per la corrispondenza del volto, ridimensionata e ritagliata a 640x640 quando le sue dimensioni differiscono da quel formato.
face_images_data_urlfacoltativo
Tipostring | null
URL dell'archivio zip delle immagini del volto, utilizzato per creare un face ID più accurato calcolando la media degli embedding delle immagini archiviate.
negative_promptfacoltativo
Tipostring
Predefinitoblurry, low resolution, bad, ugly, low quality, pixelated, interpolated, compression artifacts, noisey, grainy
Prompt negativo che specifica i dettagli indesiderati dell'immagine. Può escludere colori, oggetti, scenari o caratteristiche e qualità più fini, come baffi, sfocatura o bassa risoluzione.
seedfacoltativo
Tipointeger | null
Seed per riprodurre immagini in Stable Diffusion. Un'immagine può essere riprodotta esattamente a ogni esecuzione mantenendo invariati la versione del modello, il prompt e il seed.
guidance_scalefacoltativo
Tiponumber
Predefinito7.5
0 – 16
Intensità di aderenza al prompt per la selezione dell'immagine, espressa come CFG (Classifier Free Guidance).
num_inference_stepsfacoltativo
Tipointeger
Predefinito50
1 – 200
Numero di passaggi di inferenza per la generazione dell'immagine; valori più elevati migliorano la qualità dell'immagine a fronte di un tempo di generazione maggiore.
num_samplesfacoltativo
Tipointeger
Predefinito4
1 – 4
Numero di campioni per il face ID, con valore predefinito 4. Aumentare il numero migliora la qualità dell'immagine, ma allunga il tempo di generazione.
widthfacoltativo
Tipointeger
Predefinito512
512 – 1024
Larghezza dell'immagine risultante.
heightfacoltativo
Tipointeger
Predefinito512
512 – 1024
Altezza dell'immagine risultante.
face_id_det_sizefacoltativo
Tipointeger
Predefinito640
64 – 640
Imposta la dimensione del modello di rilevamento del volto, riducendola se il modello non riesce a trovare un volto nell'immagine. Un'impostazione maggiore offre un rilevamento più accurato, ma è anche più lenta e ha maggiori probabilità di non rilevare affatto un volto.
base_1_5_model_repofacoltativo
Tipostring
PredefinitoSG161222/Realistic_Vision_V4.0_noVAE
URL del modello Base 1.5; il valore predefinito è `SG161222/Realistic_Vision_V4.0_noVAE`.
base_sdxl_model_repofacoltativo
Tipostring
PredefinitoSG161222/RealVisXL_V3.0
URL del modello Base SDXL; il valore predefinito è `SG161222/RealVisXL_V3.0`.
enable_safety_checkerfacoltativo
Tipoboolean
Predefinitotrue
Il controllo può essere allentato impostando false, se il chiamante è autorizzato.
obbligatorio

I parametri file accettano un URL pubblico https://, un URI data: fino a 10 MB oppure il file_url di un caricamento. File

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"
  }
}
I tuoi file, la tua sceltaOgni outputs[].url è una copia nella nostra archiviazione: conservata per sempre (a pagamento per GB-mese) oppure 7 giorni gratuitamente, in base all'impostazione dell'account o a ?storage=.
Stessa struttura per ogni modellotype, url, content_type, width, height e duration, per immagini, video e audio. output è l'oggetto risultato del modello.
Campi dell'output
image
object {url, content_type, file_name, file_size, width, height}Informazioni sul file dell'immagine generata.
seed
integerSeed della generazione di immagini, incluso il valore scelto casualmente se l'input non forniva un seed; altrimenti ripete il valore fornito.

Per gli agenti AI: questa pagina in Markdown è disponibile all'indirizzo https://doitong.com/it/developers/models/ip-adapter-face-id.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt