Passer au contenu

IP Adapter Face ID

Intégrer

Identifiant du modèle 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Cette requête: ≈0,06 $ 60 crédits API · ≈ 6,33 ₽ L’exécuter sur cette page

Obtenir une clé API
Tencent Édition d’image #ip-adapter#personalization#customization#editing

Génère des images correspondant à un visage à partir d’une photo ou d’une archive zip de photos, sur des bases SD 1.5 ou SDXL

Tencent · image

Votre premier résultat apparaîtra ici

Construisez une requête ci-dessous et exécutez-la avec votre clé API. Les sorties sont copiées dans notre stockage, conservées indéfiniment ou 7 jours gratuitement.

Créer une requête

Les contrôles sont générés à partir du schéma du modèle. Le code et le prix se mettent à jour lorsque vous les modifiez.

•requis

Décrivez l’image que vous souhaitez générer avec le plus de détails possible pour obtenir les meilleurs résultats.

par défaut 4

Nombre d’échantillons pour l’identifiant facial, par défaut 4. Augmenter ce nombre améliore la qualité de l’image, mais allonge la durée de génération.

Avancé 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
par défaut blurry, low resolutio...

Prompt négatif indiquant les détails d’image indésirables. Il peut exclure les couleurs, les objets, le décor ou des caractéristiques et qualités plus fines, comme une moustache, du flou ou une faible résolution.

Déposez un fichier, ou

Image de référence pour la correspondance faciale, redimensionnée et rognée à 640x640 lorsque ses dimensions diffèrent de cette taille.

model_type par défaut 1_5-v1

Sélection du modèle, avec 1_5 comme valeur par défaut et choix recommandé pour la plupart des usages.

URL de l’archive zip d’images de visage, utilisée pour créer un identifiant facial plus précis en moyennant les embeddings des images archivées.

par défaut SG161222/Realistic_Vi...

URL du modèle de base 1.5 ; valeur par défaut : `SG161222/Realistic_Vision_V4.0_noVAE`.

par défaut SG161222/RealVisXL_V3.0

URL du modèle de base SDXL ; valeur par défaut : `SG161222/RealVisXL_V3.0`.

par défaut 7.5

Force d'adhérence au prompt pour la sélection d'image, exprimée comme CFG (Classifier Free Guidance).

par défaut 50

Nombre d’étapes d’inférence pour la génération d’image, avec une meilleure qualité aux valeurs élevées au prix d’un temps de génération plus long.

par défaut 512

Largeur de l’image obtenue.

par défaut 512

Hauteur de l’image obtenue.

par défaut 640

Définit la taille du modèle de détection faciale ; réduisez-la si le modèle ne trouve pas de visage dans votre image. Une valeur plus élevée offre une détection plus précise, mais ralentit le traitement et augmente le risque de ne pas détecter le visage.

Graine permettant de reproduire des images dans Stable Diffusion. Une image peut être reproduite exactement à chaque exécution en conservant la version du modèle, le prompt et la graine inchangés.

POST /run/ip-adapter-face-id?wait=20 devis → 0,06 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Exécuter cette requête

Votre clé reste dans ce navigateur : elle est envoyée uniquement à la Doitong API et enregistrée dans localStorage uniquement si vous cochez Mémoriser. Obtenir une clé API

À propos de IP Adapter Face ID

Personnalise la génération à partir d'un visage fourni via `face_image_url`, ou d'une archive zip de plusieurs visages via `face_images_data_url`, dont les embeddings sont moyennés. `model_type` sélectionne des variantes SD 1.5 et SDXL, et les points de contrôle de base peuvent être modifiés avec des paramètres de dépôt. `width` et `height` vont de 512 à 1024, et `num_inference_steps` va jusqu'à 200.

Paramètres

NomType Par défautAutorisé Description
model_typefacultatif
Typeenum
Par défaut1_5-v1
1_5-v11_5-v1-plus1_5-v2-plusSDXL-v1SDXL-v2-plus1_5-auraface-v1
Sélection du modèle, avec 1_5 comme valeur par défaut et choix recommandé pour la plupart des usages.
promptrequis
Typestring
Décrivez l’image que vous souhaitez générer avec le plus de détails possible pour obtenir les meilleurs résultats.
face_image_urlfacultatif
Typeurl · image
Image de référence pour la correspondance faciale, redimensionnée et rognée à 640x640 lorsque ses dimensions diffèrent de cette taille.
face_images_data_urlfacultatif
Typestring | null
URL de l’archive zip d’images de visage, utilisée pour créer un identifiant facial plus précis en moyennant les embeddings des images archivées.
negative_promptfacultatif
Typestring
Par défautblurry, low resolution, bad, ugly, low quality, pixelated, interpolated, compression artifacts, noisey, grainy
Prompt négatif indiquant les détails d’image indésirables. Il peut exclure les couleurs, les objets, le décor ou des caractéristiques et qualités plus fines, comme une moustache, du flou ou une faible résolution.
seedfacultatif
Typeinteger | null
Graine permettant de reproduire des images dans Stable Diffusion. Une image peut être reproduite exactement à chaque exécution en conservant la version du modèle, le prompt et la graine inchangés.
guidance_scalefacultatif
Typenumber
Par défaut7.5
0 – 16
Force d'adhérence au prompt pour la sélection d'image, exprimée comme CFG (Classifier Free Guidance).
num_inference_stepsfacultatif
Typeinteger
Par défaut50
1 – 200
Nombre d’étapes d’inférence pour la génération d’image, avec une meilleure qualité aux valeurs élevées au prix d’un temps de génération plus long.
num_samplesfacultatif
Typeinteger
Par défaut4
1 – 4
Nombre d’échantillons pour l’identifiant facial, par défaut 4. Augmenter ce nombre améliore la qualité de l’image, mais allonge la durée de génération.
widthfacultatif
Typeinteger
Par défaut512
512 – 1 024
Largeur de l’image obtenue.
heightfacultatif
Typeinteger
Par défaut512
512 – 1 024
Hauteur de l’image obtenue.
face_id_det_sizefacultatif
Typeinteger
Par défaut640
64 – 640
Définit la taille du modèle de détection faciale ; réduisez-la si le modèle ne trouve pas de visage dans votre image. Une valeur plus élevée offre une détection plus précise, mais ralentit le traitement et augmente le risque de ne pas détecter le visage.
base_1_5_model_repofacultatif
Typestring
Par défautSG161222/Realistic_Vision_V4.0_noVAE
URL du modèle de base 1.5 ; valeur par défaut : `SG161222/Realistic_Vision_V4.0_noVAE`.
base_sdxl_model_repofacultatif
Typestring
Par défautSG161222/RealVisXL_V3.0
URL du modèle de base SDXL ; valeur par défaut : `SG161222/RealVisXL_V3.0`.
enable_safety_checkerfacultatif
Typeboolean
Par défauttrue
Le filtrage peut être assoupli en définissant false, si l'appelant est autorisé.
requis

Les paramètres de fichier acceptent une URL publique https://, un URI data: jusqu’à 10 MB ou le file_url d’un téléversement. Fichiers

Sortie

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Vos fichiers, votre choixChaque outputs[].url est une copie dans notre stockage : conservée indéfiniment (facturation au Go-mois) ou 7 jours gratuitement, selon le réglage de votre compte ou ?storage=.
Même structure pour chaque modèletype, url, content_type, width, height et duration, pour les images, vidéos et fichiers audio. output est le propre objet de résultat du modèle.
Champs de sortie
image
object {url, content_type, file_name, file_size, width, height}Informations de fichier pour l’image générée.
seed
integerSeed de génération d'images, y compris la valeur choisie aléatoirement si l'entrée n'en fournissait pas ; sinon, il reprend la valeur fournie.

Pour les agents IA : cette page au format Markdown est disponible à https://doitong.com/fr/developers/models/ip-adapter-face-id.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt