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 foto o un archivo zip de fotos, sobre bases SD 1.5 o SDXL

Tencent · Imagen

Tu primer resultado aparecerá aquí

Crea una solicitud abajo y ejecútala con tu clave de API. Las salidas se copian en nuestro almacenamiento, donde se conservan 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 conforme los cambias.

•obligatorio

Describa la imagen que desea generar con el mayor detalle posible para obtener los mejores resultados.

predeterminado 4

Cantidad de muestras para el ID facial; el valor predeterminado es 4. Aumentar la cantidad 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 finas, como un bigote, desenfoque o baja resolución.

Suelta un archivo o

Imagen de referencia para 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, donde 1_5 es tanto el valor predeterminado como 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 mediante el promedio de 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 adherencia al prompt para la selección de imágenes, expresada como CFG (Classifier Free Guidance).

predeterminado 50

Cantidad de pasos de inferencia para la generación de imágenes; una mayor cantidad mejora la calidad de imagen a costa de un tiempo de generación más largo.

predeterminado 512

Ancho de la imagen resultante.

predeterminado 512

Alto 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 valor mayor ofrece una detección más precisa, pero también tarda más y es más probable que no detecte 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 cotización → $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 se guarda en localStorage únicamente 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 de 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, donde 1_5 es tanto el valor predeterminado como la opción recomendada para la mayoría de los usos.
promptobligatorio
Tipostring
Describa la imagen que desea generar con el mayor detalle posible para obtener los mejores resultados.
face_image_urlopcional
Tipourl · image
Imagen de referencia para 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 mediante el promedio de 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 finas, 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 adherencia al prompt para la selección de imágenes, expresada como CFG (Classifier Free Guidance).
num_inference_stepsopcional
Tipointeger
Predeterminado50
1 – 200
Cantidad de pasos de inferencia para la generación de imágenes; una mayor cantidad mejora la calidad de imagen a costa de un tiempo de generación más largo.
num_samplesopcional
Tipointeger
Predeterminado4
1 – 4
Cantidad de muestras para el ID facial; el valor predeterminado es 4. Aumentar la cantidad mejora la calidad de la imagen, pero alarga el tiempo de generación.
widthopcional
Tipointeger
Predeterminado512
512 – 1,024
Ancho de la imagen resultante.
heightopcional
Tipointeger
Predeterminado512
512 – 1,024
Alto 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 valor mayor ofrece una detección más precisa, pero también tarda más y es más probable que no detecte 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 llama 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 carga. 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: se conserva para siempre (con cobro 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 video 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 omitió una semilla; de lo contrario, repite el valor proporcionado.

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