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 Modification 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

Créez 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 pendant 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 au fur et à mesure de vos modifications.

•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. L’augmenter améliore la qualité de l’image, mais prolonge le temps 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...

Invite négative indiquant les détails d’image indésirables. Elle 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, mise à l’échelle et rognée à 640x640 lorsque ses dimensions diffèrent.

model_type par défaut 1_5-v1

Sélection du modèle, où 1_5 est la valeur par défaut et le choix recommandé pour la plupart des utilisations.

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

par défaut SG161222/Realistic_Vi...

URL du modèle Base 1.5; par défaut, `SG161222/Realistic_Vision_V4.0_noVAE`.

par défaut SG161222/RealVisXL_V3.0

URL du modèle Base SDXL; par défaut, `SG161222/RealVisXL_V3.0`.

par défaut 7.5

Intensité d’adhésion à l’invite pour la sélection d’images, exprimée comme CFG (Classifier Free Guidance).

par défaut 50

Nombre d’étapes d’inférence pour la génération d’image; des valeurs plus élevées améliorent la qualité de l’image 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. Un réglage plus grand offre une détection plus précise, mais s’exécute plus lentement et risque davantage de ne pas détecter un visage.

Graine pour reproduire des images dans Stable Diffusion. Une image peut être reproduite exactement à chaque exécution en conservant la version du modèle, l’invite et la graine inchangées.

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 au 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 plongements 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 les paramètres du dépôt. `width` et `height` vont de 512 à 1024, et `num_inference_steps` 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, où 1_5 est la valeur par défaut et le choix recommandé pour la plupart des utilisations.
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, mise à l’échelle et rognée à 640x640 lorsque ses dimensions diffèrent.
face_images_data_urlfacultatif
Typestring | null
URL de l’archive zip d’images faciales, utilisée pour créer un identifiant facial plus précis en moyennant les représentations vectorielles des images archivées.
negative_promptfacultatif
Typestring
Par défautblurry, low resolution, bad, ugly, low quality, pixelated, interpolated, compression artifacts, noisey, grainy
Invite négative indiquant les détails d’image indésirables. Elle 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 pour reproduire des images dans Stable Diffusion. Une image peut être reproduite exactement à chaque exécution en conservant la version du modèle, l’invite et la graine inchangées.
guidance_scalefacultatif
Typenumber
Par défaut7.5
0 – 16
Intensité d’adhésion à l’invite pour la sélection d’images, 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; des valeurs plus élevées améliorent la qualité de l’image 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. L’augmenter améliore la qualité de l’image, mais prolonge le temps 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. Un réglage plus grand offre une détection plus précise, mais s’exécute plus lentement et risque davantage de ne pas détecter un visage.
base_1_5_model_repofacultatif
Typestring
Par défautSG161222/Realistic_Vision_V4.0_noVAE
URL du modèle Base 1.5; par défaut, `SG161222/Realistic_Vision_V4.0_noVAE`.
base_sdxl_model_repofacultatif
Typestring
Par défautSG161222/RealVisXL_V3.0
URL du modèle Base SDXL; par défaut, `SG161222/RealVisXL_V3.0`.
enable_safety_checkerfacultatif
Typeboolean
Par défauttrue
La vérification peut être assouplie 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 par Go-mois) ou pendant 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, les vidéos et les fichiers audio. output est l’objet de résultat propre au modèle.
Champs de sortie
image
object {url, content_type, file_name, file_size, width, height}Informations sur le fichier de l’image générée.
seed
integerGraine de génération d’image, incluant la valeur choisie aléatoirement si l’entrée n’a pas fourni de graine; sinon, elle répète la valeur fournie.

Pour les agents IA : cette page en Markdown se trouve à https://doitong.com/fr-CA/developers/models/ip-adapter-face-id.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt