Avançar para o conteúdo

IP Adapter Face ID

Integrar

ID do 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"

Este pedido: ≈0,06 $ 60 créditos da API Executar nesta página

Obter chave de API
Tencent Edição de imagem #ip-adapter#personalization#customization#editing

Gera imagens correspondentes a uma cara a partir de uma fotografia ou de um zip de fotografias, em bases SD 1.5 ou SDXL

Tencent · Imagem

O seu primeiro resultado aparece aqui

Crie um pedido abaixo e execute-o com a sua chave de API. As saídas são copiadas para o nosso armazenamento, guardadas para sempre ou durante 7 dias gratuitamente.

Criar um pedido

Os controlos são gerados a partir do esquema do modelo. O código e o preço são atualizados à medida que os altera.

•obrigatório

Descreva a imagem que pretende gerar, utilizando o máximo de detalhe possível para obter os melhores resultados.

predefinição 4

Número de amostras para o ID facial, com predefinição de 4. Aumentar este número melhora a qualidade da imagem, mas prolonga o tempo de geração.

Avançado 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
predefinição blurry, low resolutio...

Negative prompt que especifica detalhes de imagem indesejados. Pode excluir cores, objetos, cenários ou características e qualidades mais finas, como um bigode, desfocagem ou baixa resolução.

Largue um ficheiro ou

Imagem de referência para correspondência facial, redimensionada e recortada para 640x640 sempre que as dimensões forem diferentes.

model_type predefinição 1_5-v1

Seleção do modelo, com 1_5 a servir de predefinição e opção recomendada para a maioria dos usos.

URL do arquivo zip de imagens faciais, utilizado para criar um ID facial mais preciso através da média dos embeddings das imagens arquivadas.

predefinição SG161222/Realistic_Vi...

URL do modelo base 1.5; predefinido como `SG161222/Realistic_Vision_V4.0_noVAE`.

predefinição SG161222/RealVisXL_V3.0

URL do modelo base SDXL; predefinido como `SG161222/RealVisXL_V3.0`.

predefinição 7.5

Intensidade de adesão ao prompt para seleção de imagens, expressa como CFG (Classifier Free Guidance).

predefinição 50

Número de passos de inferência da geração de imagens, com melhor qualidade de imagem em números maiores, à custa de um tempo de geração mais longo.

predefinição 512

Largura da imagem resultante.

predefinição 512

Altura da imagem resultante.

predefinição 640

Define o tamanho do modelo de deteção facial, reduzindo-o se o modelo não conseguir encontrar um rosto na imagem. Uma definição maior proporciona uma deteção mais precisa, mas também é mais lenta e tem maior probabilidade de não detetar qualquer rosto.

Seed para reproduzir imagens no Stable Diffusion. Uma imagem pode ser reproduzida exatamente em cada execução mantendo inalteradas a versão do modelo, o prompt e a seed.

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

Executar este pedido

A sua chave permanece neste navegador: é enviada apenas para a Doitong API e guardada em localStorage apenas se selecionar Lembrar. Obter uma chave de API

Sobre IP Adapter Face ID

Personaliza a geração para uma cara fornecida como `face_image_url` ou como várias caras num zip através de `face_images_data_url`, cujos embeddings são calculados em média. `model_type` seleciona entre variantes SD 1.5 e SDXL e os checkpoints base podem ser alterados com parâmetros do repositório. `width` e `height` variam de 512 a 1024 e `num_inference_steps` vai até 200.

Parâmetros

NomeTipo PredefiniçãoPermitido Descrição
model_typeopcional
Tipoenum
Predefinição1_5-v1
1_5-v11_5-v1-plus1_5-v2-plusSDXL-v1SDXL-v2-plus1_5-auraface-v1
Seleção do modelo, com 1_5 a servir de predefinição e opção recomendada para a maioria dos usos.
promptobrigatório
Tipostring
Descreva a imagem que pretende gerar, utilizando o máximo de detalhe possível para obter os melhores resultados.
face_image_urlopcional
Tipourl · image
Imagem de referência para correspondência facial, redimensionada e recortada para 640x640 sempre que as dimensões forem diferentes.
face_images_data_urlopcional
Tipostring | null
URL do arquivo zip de imagens faciais, utilizado para criar um ID facial mais preciso através da média dos embeddings das imagens arquivadas.
negative_promptopcional
Tipostring
Predefiniçãoblurry, low resolution, bad, ugly, low quality, pixelated, interpolated, compression artifacts, noisey, grainy
Negative prompt que especifica detalhes de imagem indesejados. Pode excluir cores, objetos, cenários ou características e qualidades mais finas, como um bigode, desfocagem ou baixa resolução.
seedopcional
Tipointeger | null
Seed para reproduzir imagens no Stable Diffusion. Uma imagem pode ser reproduzida exatamente em cada execução mantendo inalteradas a versão do modelo, o prompt e a seed.
guidance_scaleopcional
Tiponumber
Predefinição7.5
0 – 16
Intensidade de adesão ao prompt para seleção de imagens, expressa como CFG (Classifier Free Guidance).
num_inference_stepsopcional
Tipointeger
Predefinição50
1 – 200
Número de passos de inferência da geração de imagens, com melhor qualidade de imagem em números maiores, à custa de um tempo de geração mais longo.
num_samplesopcional
Tipointeger
Predefinição4
1 – 4
Número de amostras para o ID facial, com predefinição de 4. Aumentar este número melhora a qualidade da imagem, mas prolonga o tempo de geração.
widthopcional
Tipointeger
Predefinição512
512 – 1024
Largura da imagem resultante.
heightopcional
Tipointeger
Predefinição512
512 – 1024
Altura da imagem resultante.
face_id_det_sizeopcional
Tipointeger
Predefinição640
64 – 640
Define o tamanho do modelo de deteção facial, reduzindo-o se o modelo não conseguir encontrar um rosto na imagem. Uma definição maior proporciona uma deteção mais precisa, mas também é mais lenta e tem maior probabilidade de não detetar qualquer rosto.
base_1_5_model_repoopcional
Tipostring
PredefiniçãoSG161222/Realistic_Vision_V4.0_noVAE
URL do modelo base 1.5; predefinido como `SG161222/Realistic_Vision_V4.0_noVAE`.
base_sdxl_model_repoopcional
Tipostring
PredefiniçãoSG161222/RealVisXL_V3.0
URL do modelo base SDXL; predefinido como `SG161222/RealVisXL_V3.0`.
enable_safety_checkeropcional
Tipoboolean
Predefiniçãotrue
A filtragem pode ser flexibilizada definindo false, desde que o autor do pedido esteja autorizado.
obrigatório

Os parâmetros de ficheiro aceitam um URL https:// público, um URI data: até 10 MB ou o file_url de um carregamento. Ficheiros

Resultado

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"
  }
}
Os seus ficheiros, a sua escolhaCada outputs[].url é uma cópia no nosso armazenamento: guardada para sempre (paga por GB-mês) ou durante 7 dias gratuitamente, conforme a definição da sua conta ou ?storage=.
A mesma estrutura em todos os modelostype, url, content_type, width, height e duration, tanto para imagens como para vídeo e áudio. output é o próprio objeto de resultado do modelo.
Campos do resultado
image
object {url, content_type, file_name, file_size, width, height}Informações do ficheiro da imagem gerada.
seed
integerSeed da geração de imagens, incluindo o valor escolhido aleatoriamente se a entrada não tiver fornecido uma seed; caso contrário, repete o valor fornecido.

Para agentes de IA: esta página em Markdown está disponível em https://doitong.com/pt-PT/developers/models/ip-adapter-face-id.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt