Rosto real ou de IA API

Introdução API

Verifique se um rosto parece real ou gerado por IA, incluindo sinais de rostos sintéticos, troca de rostos por IA e retoque intenso assistido por IA. O modelo analisa toda a imagem e retorna uma pontuação de risco de geração por IA.

Parâmetros de Solicitação: Arquivos de retrato compatíveis de até 10 MB.
Parâmetros de resposta: Uma pontuação mais alta indica sinais de geração por IA mais fortes na imagem inteira. Use-a como sinal de revisão, não como prova de que a imagem é real.

Introdução API

Verificar se uma foto de perfil parece real ou gerada por IA
Analisar selfies e retratos em busca de sinais de rostos sintéticos
Identificar possível troca de rostos por IA ou retoque intenso assistido por IA

Autenticação

Substitua {your-api-domain} pelo endpoint de API mostrado no painel da sua conta.

Autentique solicitações com o endpoint da API da sua conta e um token Bearer. Após comprar créditos de API, você pode ver seu endpoint e token no painel da conta. Mantenha seu token em segredo e nunca o envie para repositórios públicos.

POSThttps://api.imgauth.com/v1/real-or-ai-face

Authorization: Bearer {YOUR_API_TOKEN}
Content-Type: application/json; charset=UTF-8

Parâmetros de Solicitação

Parâmetro	Tipo	✓	Descrição
image	string	✓	Arquivos de retrato compatíveis de até 10 MB.

Exemplo de Solicitação HTTP

{
  "image": "<BASE64_IMAGE_WITHOUT_PREFIX>"
}

Parâmetros de resposta

Parâmetro	Tipo	Descrição
code	integer	Referência para códigos de resposta API
request_id	string	Use estes exemplos para construir e depurar sua integração
data.ai_generated	boolean \| null	Imagem facial provavelmente gerada ou substancialmente editada por IA / Nenhum sinal forte de geração por IA detectado
data.ai_generation_score	number \| null	Uma pontuação mais alta indica sinais de geração por IA mais fortes na imagem inteira. Use-a como sinal de revisão, não como prova de que a imagem é real.
data.review_status	"likely_ai" \| "likely_not_ai" \| "review"	Revisão recomendada
data.analysis_scope	"portrait"	Verifique se um rosto parece real ou gerado por IA, incluindo sinais de rostos sintéticos, troca de rostos por IA e retoque intenso assistido por IA. O modelo analisa toda a imagem e retorna uma pontuação de risco de geração por IA.

Exemplos de Resposta

{
  "code": 0,
  "request_id": "req_01...",
  "data": {
    "ai_generated": true,
    "ai_generation_score": 0.89,
    "review_status": "likely_ai",
    "analysis_scope": "portrait"
  }
}

Códigos de Erro

400INVALID_REQUESTOs API messages são exibidos com os valores brutos do serviço upstream para corresponder exatamente às respostas de produção.

401INVALID_API_KEYOs API messages são exibidos com os valores brutos do serviço upstream para corresponder exatamente às respostas de produção.

402CREDITS_EXHAUSTEDOs API messages são exibidos com os valores brutos do serviço upstream para corresponder exatamente às respostas de produção.

403API_KEY_INACTIVE / API_KEY_EXPIREDOs API messages são exibidos com os valores brutos do serviço upstream para corresponder exatamente às respostas de produção.

413PAYLOAD_TOO_LARGEOs API messages são exibidos com os valores brutos do serviço upstream para corresponder exatamente às respostas de produção.

415UNSUPPORTED_IMAGEOs API messages são exibidos com os valores brutos do serviço upstream para corresponder exatamente às respostas de produção.

502UPSTREAM_ERROROs API messages são exibidos com os valores brutos do serviço upstream para corresponder exatamente às respostas de produção.

504UPSTREAM_TIMEOUTOs API messages são exibidos com os valores brutos do serviço upstream para corresponder exatamente às respostas de produção.

Exemplos de Código

curl -X POST "https://api.imgauth.com/v1/real-or-ai-face" \
  -H "Authorization: Bearer rh_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "image": "<BASE64_IMAGE_WITHOUT_PREFIX>"
}'