Comparação facial por API. Simples de integrar, fácil de escalar.
Envie duas imagens faciais e receba a pontuação de similaridade cosseno em milissegundos. Você mantém seus próprios usuários e fotos; a Conformo não mantém cadastro centralizado das pessoas comparadas.
Valor real para sua operação, além do preço por chamada
Comparar duas imagens custa R$ 0,06, mas o ganho principal está em destravar fluxos que antes exigiam conferência manual lenta ou contratos caros em dólar.
Como funciona
Do cadastro à primeira chamada autenticada sem depender de atendimento comercial.
Crie uma conta
Cadastre sua organização e receba acesso ao sandbox com R$ 5,00 promocionais quando elegível.
Gere sua API key
Crie chaves com escopo definido para sandbox ou produção. Use sempre no backend.
Envie duas imagens
Submeta referência e foto alvo em JPEG/PNG via multipart/form-data ou Base64.
Receba o resultado
Obtenha similaridade cosseno, status (match, no_match ou inconclusive) e operation_id.
Integração direta em qualquer stack
Uma chamada REST padrão com autenticação Bearer, suporte a Idempotency-Key para evitar cobrança duplicada em retries de rede e respostas padronizadas em RFC 9457.
- Nunca insira sua API key privada em código JavaScript executado no navegador.
- Defina o
thresholdconforme o risco do seu fluxo. - Trate retornos
inconclusivecom fluxo de contingência humana.
curl -X POST https://api.conformo.com.br/v1/face/compare \
-H "X-API-Key: $CONFORMO_API_KEY" \
-H "Idempotency-Key: 9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d" \
-F "source_image=@./referencia.jpg" \
-F "target_image=@./selfie.jpg" using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(15) };
http.DefaultRequestHeaders.Add("X-API-Key", Environment.GetEnvironmentVariable("CONFORMO_API_KEY"));
http.DefaultRequestHeaders.Add("Idempotency-Key", Guid.NewGuid().ToString());
using var form = new MultipartFormDataContent();
form.Add(new StreamContent(File.OpenRead("referencia.jpg")), "source_image", "referencia.jpg");
form.Add(new StreamContent(File.OpenRead("selfie.jpg")), "target_image", "selfie.jpg");
var response = await http.PostAsync("https://api.conformo.com.br/v1/face/compare", form);
var body = await response.Content.ReadAsStringAsync(); import fs from "node:fs";
import crypto from "node:crypto";
const form = new FormData();
form.append("source_image", new Blob([fs.readFileSync("referencia.jpg")], { type: "image/jpeg" }), "referencia.jpg");
form.append("target_image", new Blob([fs.readFileSync("selfie.jpg")], { type: "image/jpeg" }), "selfie.jpg");
const res = await fetch("https://api.conformo.com.br/v1/face/compare", {
method: "POST",
headers: {
"X-API-Key": process.env.CONFORMO_API_KEY ?? "",
"Idempotency-Key": crypto.randomUUID()
},
body: form,
signal: AbortSignal.timeout(15000)
});
const data = await res.json(); import os
import uuid
import requests
with open("referencia.jpg", "rb") as src, open("selfie.jpg", "rb") as tgt:
response = requests.post(
"https://api.conformo.com.br/v1/face/compare",
headers={
"X-API-Key": os.environ["CONFORMO_API_KEY"],
"Idempotency-Key": str(uuid.uuid4()),
},
files={"source_image": src, "target_image": tgt},
timeout=15,
)
print(response.status_code, response.json()) Playground demonstrativo
Veja como a API responde em cenários de sucesso, qualidade limítrofe e erros faturáveis ou não faturáveis.
Inspecione o comportamento da API
Esta prévia demonstra o formato JSON real de POST /v1/face/compare definido em contracts/openapi.yaml.
Para enviar suas próprias fotos ou testar com câmera em tempo real, acesse o Console autenticado.
Aplicações legítimas e limites claros
Transparência técnica para você projetar fluxos seguros no seu software.
Onde usar a Conformo Face
- Conferência 1:1 entre foto de cadastro existente e nova foto enviada pelo usuário.
- Segundo fator visual complementar em fluxos internos ou corporativos.
- Automação de triagem em software houses e sistemas de gestão de acesso com supervisão.
O que a Conformo Face NÃO faz
- Não executa prova de vida (liveness): não detecta ataques de apresentação com fotos impressas ou telas.
- Não garante 100% de precisão: iluminação, ângulo e baixa resolução geram incerteza.
- Não substitui decisão jurídica ou antifraude completo: use como sinal técnico dentro da sua política de risco.
Pague apenas pelo que comparar
Comece com R$ 5,00 em créditos promocionais (cerca de 83 comparações para validar sua integração). Quando precisar escalar, recarregue via Pix ou contrate uma assinatura com franquia mensal.
Simular volume e ver planos- Sem taxa mínima mensal no modelo pré-pago
- Recarga instantânea via Pix no console
- Alertas configuráveis de saldo baixo
- Distinção clara entre crédito promocional, pago e reservado
Segurança e privacidade por arquitetura
Infraestrutura própria (sem AWS)
O processamento facial é executado em infraestrutura dedicada própria, sem envio de imagens para APIs de terceiros ou nuvem AWS.
Sem armazenamento permanente no MVP
As imagens são processadas de forma transitória durante a requisição para extração e comparação, sem manter galeria biométrica das pessoas comparadas.
Responsabilidade compartilhada na LGPD
Você mantém o controle da base legal, consentimento e guarda dos dados dos seus usuários. Leia nossa página de Segurança.
Perguntas frequentes de desenvolvedores
A Conformo Face faz prova de vida (liveness)?
Não. A API compara duas imagens faciais 1:1 e retorna uma pontuação de similaridade. Ela não verifica se a imagem foi capturada ao vivo diante de uma câmera.
Posso chamar a API diretamente do frontend JavaScript do meu cliente?
Não. Nunca exponha sua API key privada no navegador ou aplicativo móvel. Envie as imagens para o seu próprio backend e faça a chamada para api.conformo.com.br a partir do servidor.
O que acontece se a imagem não tiver rosto ou tiver mais de um rosto?
A API retorna HTTP 422 no padrão Problem Details (RFC 9457) com error_code específico (como no_face_detected ou multiple_faces_detected) e requestId para suporte.
Como evitar cobrança duplicada se minha rede falhar?
Envie um UUID único no header Idempotency-Key em cada tentativa lógica de comparação. Retries com a mesma chave não geram nova execução faturável.