Ir al contenido

IP Adapter Face ID

Integrar

ID del modelo 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"

Esta solicitud: ≈0,06 $ 60 créditos de API Ejecutar en esta página

Obtener clave de API
Tencent Edición de imágenes #ip-adapter#personalization#customization#editing

Genera imágenes que coinciden con un rostro de una fotografía o un zip de fotografías, sobre bases SD 1.5 o SDXL

Tencent · Imagen

Tu primer resultado aparecerá aquí

Crea una solicitud a continuación y ejecútala con tu clave de API. Las salidas se copian en nuestro almacenamiento, conservadas para siempre o 7 días gratis.

Crear una solicitud

Los controles se generan a partir del esquema del modelo. El código y el precio se actualizan al modificarlos.

•obligatorio

Describe la imagen que quieres generar con el mayor detalle posible para obtener los mejores resultados.

predeterminado 4

Número de muestras para el ID facial, con un valor predeterminado de 4. Aumentarlo mejora la calidad de la imagen, pero alarga el tiempo de generación.

Avanzado 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
predeterminado blurry, low resolutio...

Prompt negativo que especifica detalles de imagen no deseados. Puede excluir colores, objetos, paisajes o características y cualidades más precisas, como un bigote, desenfoque o baja resolución.

Suelta un archivo o

Imagen de referencia para la coincidencia facial, escalada y recortada a 640x640 cuando sus dimensiones difieren de ese tamaño.

model_type predeterminado 1_5-v1

Selección del modelo; 1_5 es el valor predeterminado y la opción recomendada para la mayoría de los usos.

URL del archivo ZIP de imágenes faciales, utilizado para crear un ID facial más preciso promediando los embeddings de las imágenes archivadas.

predeterminado SG161222/Realistic_Vi...

URL del modelo base 1.5; el valor predeterminado es `SG161222/Realistic_Vision_V4.0_noVAE`.

predeterminado SG161222/RealVisXL_V3.0

URL del modelo base SDXL; el valor predeterminado es `SG161222/RealVisXL_V3.0`.

predeterminado 7.5

Intensidad de seguimiento del prompt para la selección de imágenes, expresada como CFG (Classifier Free Guidance).

predeterminado 50

Número de pasos de inferencia de generación de imágenes, con una mejor calidad de imagen en números mayores a costa de un tiempo de generación más largo.

predeterminado 512

Anchura de la imagen resultante.

predeterminado 512

Altura de la imagen resultante.

predeterminado 640

Establece el tamaño del modelo de detección facial; redúcelo si el modelo no encuentra un rostro en la imagen. Un ajuste mayor ofrece una detección más precisa, pero también funciona más lentamente y tiene más probabilidades de no detectar ningún rostro.

Semilla para reproducir imágenes en Stable Diffusion. Una imagen puede reproducirse exactamente en cada ejecución si se mantienen sin cambios la versión del modelo, el prompt y la semilla.

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

Ejecutar esta solicitud

Tu clave permanece en este navegador: solo se envía a la Doitong API y solo se guarda en localStorage si marcas Recordar. Obtener una clave de API

Acerca de IP Adapter Face ID

Personaliza la generación para un rostro proporcionado como `face_image_url`, o como un zip de varios rostros mediante `face_images_data_url`, cuyos embeddings se promedian. `model_type` selecciona entre variantes SD 1.5 y SDXL, y los puntos de control base se pueden cambiar con parámetros del repositorio. `width` y `height` van de 512 a 1024, y `num_inference_steps` llega hasta 200.

Parámetros

NombreTipo PredeterminadoPermitido Descripción
model_typeopcional
Tipoenum
Predeterminado1_5-v1
1_5-v11_5-v1-plus1_5-v2-plusSDXL-v1SDXL-v2-plus1_5-auraface-v1
Selección del modelo; 1_5 es el valor predeterminado y la opción recomendada para la mayoría de los usos.
promptobligatorio
Tipostring
Describe la imagen que quieres generar con el mayor detalle posible para obtener los mejores resultados.
face_image_urlopcional
Tipourl · image
Imagen de referencia para la coincidencia facial, escalada y recortada a 640x640 cuando sus dimensiones difieren de ese tamaño.
face_images_data_urlopcional
Tipostring | null
URL del archivo ZIP de imágenes faciales, utilizado para crear un ID facial más preciso promediando los embeddings de las imágenes archivadas.
negative_promptopcional
Tipostring
Predeterminadoblurry, low resolution, bad, ugly, low quality, pixelated, interpolated, compression artifacts, noisey, grainy
Prompt negativo que especifica detalles de imagen no deseados. Puede excluir colores, objetos, paisajes o características y cualidades más precisas, como un bigote, desenfoque o baja resolución.
seedopcional
Tipointeger | null
Semilla para reproducir imágenes en Stable Diffusion. Una imagen puede reproducirse exactamente en cada ejecución si se mantienen sin cambios la versión del modelo, el prompt y la semilla.
guidance_scaleopcional
Tiponumber
Predeterminado7.5
0 – 16
Intensidad de seguimiento del prompt para la selección de imágenes, expresada como CFG (Classifier Free Guidance).
num_inference_stepsopcional
Tipointeger
Predeterminado50
1 – 200
Número de pasos de inferencia de generación de imágenes, con una mejor calidad de imagen en números mayores a costa de un tiempo de generación más largo.
num_samplesopcional
Tipointeger
Predeterminado4
1 – 4
Número de muestras para el ID facial, con un valor predeterminado de 4. Aumentarlo mejora la calidad de la imagen, pero alarga el tiempo de generación.
widthopcional
Tipointeger
Predeterminado512
512 – 1024
Anchura de la imagen resultante.
heightopcional
Tipointeger
Predeterminado512
512 – 1024
Altura de la imagen resultante.
face_id_det_sizeopcional
Tipointeger
Predeterminado640
64 – 640
Establece el tamaño del modelo de detección facial; redúcelo si el modelo no encuentra un rostro en la imagen. Un ajuste mayor ofrece una detección más precisa, pero también funciona más lentamente y tiene más probabilidades de no detectar ningún rostro.
base_1_5_model_repoopcional
Tipostring
PredeterminadoSG161222/Realistic_Vision_V4.0_noVAE
URL del modelo base 1.5; el valor predeterminado es `SG161222/Realistic_Vision_V4.0_noVAE`.
base_sdxl_model_repoopcional
Tipostring
PredeterminadoSG161222/RealVisXL_V3.0
URL del modelo base SDXL; el valor predeterminado es `SG161222/RealVisXL_V3.0`.
enable_safety_checkeropcional
Tipoboolean
Predeterminadotrue
La moderación puede relajarse estableciendo false, siempre que la persona que realiza la solicitud esté autorizada.
obligatorio

Los parámetros de archivo aceptan una URL pública https://, un URI data: de hasta 10 MB o el file_url de una subida. Archivos

Salida

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"
  }
}
Tus archivos, tú eligesCada outputs[].url es una copia en nuestro almacenamiento: conservada para siempre (con pago por GB-mes) o 7 días gratis, según la configuración de tu cuenta o ?storage=.
La misma estructura en todos los modelostype, url, content_type, width, height y duration, tanto para imágenes como para vídeo y audio. output es el objeto de resultado propio del modelo.
Campos de salida
image
object {url, content_type, file_name, file_size, width, height}Información del archivo de la imagen generada.
seed
integerSemilla de generación de imágenes, incluido el valor elegido aleatoriamente si la entrada no proporcionó una semilla; de lo contrario, repite el valor proporcionado.

Para agentes de IA: esta página en Markdown está en https://doitong.com/es-ES/developers/models/ip-adapter-face-id.md. Todos los modelos y guías: https://doitong.com/developers/llms.txt