Ir 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"

Esta solicitação: ≈$ 0,06 60 créditos de API Executar nesta página

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

Gera imagens que correspondem a um rosto de uma foto ou de um zip de fotos, em bases SD 1.5 ou SDXL

Tencent · Imagem

Seu primeiro resultado aparecerá aqui

Monte uma requisição abaixo e execute-a com sua chave de API. As saídas são copiadas para nosso armazenamento, mantidas para sempre ou por 7 dias gratuitamente.

Criar uma solicitação

Os controles são gerados a partir do esquema do modelo. O código e o preço são atualizados conforme você os altera.

•obrigatório

Descreva a imagem que deseja gerar com o máximo de detalhes possível para obter os melhores resultados.

padrão 4

Quantidade de amostras para o ID facial, com padrão de 4. Aumentar a quantidade 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
padrão blurry, low resolutio...

Prompt negativo que especifica detalhes indesejados da imagem. Ele pode excluir cores, objetos, cenários ou características e qualidades mais sutis, como bigode, desfoque ou baixa resolução.

Solte um arquivo ou

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

model_type padrão 1_5-v1

Seleção de modelo, com 1_5 servindo como padrão e opção recomendada para a maioria dos usos.

URL do arquivo zip de imagens faciais, usado para criar um ID facial mais preciso calculando a média dos embeddings das imagens arquivadas.

padrão SG161222/Realistic_Vi...

URL do modelo Base 1.5; o padrão é `SG161222/Realistic_Vision_V4.0_noVAE`.

padrão SG161222/RealVisXL_V3.0

URL do modelo Base SDXL; o padrão é `SG161222/RealVisXL_V3.0`.

padrão 7.5

Intensidade de aderência ao prompt para seleção de imagem, expressa como CFG (Classifier Free Guidance).

padrão 50

Quantidade de etapas de inferência da geração de imagem, com melhor qualidade em quantidades maiores, ao custo de um tempo de geração mais longo.

padrão 512

Largura da imagem resultante.

padrão 512

Altura da imagem resultante.

padrão 640

Define o tamanho do modelo de detecção facial, reduzindo-o se o modelo não encontrar um rosto na imagem. Uma configuração maior fornece uma detecção mais precisa, mas também é mais lenta e tem maior probabilidade de não encontrar nenhum rosto.

Seed para reproduzir imagens no Stable Diffusion. Uma imagem pode ser reproduzida exatamente em cada execução mantendo inalterados 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 esta solicitação

Sua chave permanece neste navegador: ela é enviada somente à Doitong API e salva (localStorage) apenas se você marcar Lembrar. Obter uma chave de API

Sobre IP Adapter Face ID

Personaliza a geração para um rosto fornecido como `face_image_url` ou como um zip de vários rostos por meio de `face_images_data_url`, cujos embeddings são calculados pela média. `model_type` seleciona entre variantes SD 1.5 e SDXL, e os checkpoints base podem ser alterados com parâmetros de repositório. `width` e `height` variam de 512 a 1024, e `num_inference_steps` vai até 200.

Parâmetros

NomeTipo PadrãoPermitido Descrição
model_typeopcional
Tipoenum
Padrão1_5-v1
1_5-v11_5-v1-plus1_5-v2-plusSDXL-v1SDXL-v2-plus1_5-auraface-v1
Seleção de modelo, com 1_5 servindo como padrão e opção recomendada para a maioria dos usos.
promptobrigatório
Tipostring
Descreva a imagem que deseja gerar com o máximo de detalhes 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 suas dimensões forem diferentes desse tamanho.
face_images_data_urlopcional
Tipostring | null
URL do arquivo zip de imagens faciais, usado para criar um ID facial mais preciso calculando a média dos embeddings das imagens arquivadas.
negative_promptopcional
Tipostring
Padrãoblurry, low resolution, bad, ugly, low quality, pixelated, interpolated, compression artifacts, noisey, grainy
Prompt negativo que especifica detalhes indesejados da imagem. Ele pode excluir cores, objetos, cenários ou características e qualidades mais sutis, como bigode, desfoque 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 inalterados a versão do modelo, o prompt e a seed.
guidance_scaleopcional
Tiponumber
Padrão7.5
0 – 16
Intensidade de aderência ao prompt para seleção de imagem, expressa como CFG (Classifier Free Guidance).
num_inference_stepsopcional
Tipointeger
Padrão50
1 – 200
Quantidade de etapas de inferência da geração de imagem, com melhor qualidade em quantidades maiores, ao custo de um tempo de geração mais longo.
num_samplesopcional
Tipointeger
Padrão4
1 – 4
Quantidade de amostras para o ID facial, com padrão de 4. Aumentar a quantidade melhora a qualidade da imagem, mas prolonga o tempo de geração.
widthopcional
Tipointeger
Padrão512
512 – 1.024
Largura da imagem resultante.
heightopcional
Tipointeger
Padrão512
512 – 1.024
Altura da imagem resultante.
face_id_det_sizeopcional
Tipointeger
Padrão640
64 – 640
Define o tamanho do modelo de detecção facial, reduzindo-o se o modelo não encontrar um rosto na imagem. Uma configuração maior fornece uma detecção mais precisa, mas também é mais lenta e tem maior probabilidade de não encontrar nenhum rosto.
base_1_5_model_repoopcional
Tipostring
PadrãoSG161222/Realistic_Vision_V4.0_noVAE
URL do modelo Base 1.5; o padrão é `SG161222/Realistic_Vision_V4.0_noVAE`.
base_sdxl_model_repoopcional
Tipostring
PadrãoSG161222/RealVisXL_V3.0
URL do modelo Base SDXL; o padrão é `SG161222/RealVisXL_V3.0`.
enable_safety_checkeropcional
Tipoboolean
Padrãotrue
A filtragem pode ser relaxada definindo false, desde que o chamador esteja autorizado.
obrigatório

Os parâmetros de arquivo aceitam uma URL https:// pública, um URI data: de até 10 MB ou o file_url de um upload. Arquivos

Saída

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"
  }
}
Seus arquivos, sua escolhaCada outputs[].url é uma cópia em nosso armazenamento: mantida para sempre (cobrada por GB-mês) ou por 7 dias gratuitamente, conforme a configuração da sua conta ou ?storage=.
Mesmo formato em todos os modelostype, url, content_type, width, height e duration, para imagens, vídeos e áudios. output é o próprio objeto de resultado do modelo.
Campos da saída
image
object {url, content_type, file_name, file_size, width, height}Informações do arquivo da imagem gerada.
seed
integerSeed de geração de imagens, incluindo o valor escolhido aleatoriamente quando a entrada não forneceu uma seed; caso contrário, repete o valor fornecido.

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