Rostro real o de IA API

Introducción API

Comprueba si un rostro parece real o generado por IA, incluidas señales de rostros sintéticos, intercambio de rostros con IA y retoques intensivos asistidos por IA. El modelo analiza toda la imagen y devuelve una puntuación de riesgo de generación por IA.

Parámetros de Solicitud: Archivos de retrato compatibles de hasta 10 MB.
Parámetros de respuesta: Una puntuación más alta indica señales de generación por IA más fuertes en toda la imagen. Úsala como señal de revisión, no como prueba de que la imagen es real.

Introducción API

Comprobar si una foto de perfil parece real o generada por IA
Revisar selfies y retratos en busca de señales de rostros sintéticos
Detectar posibles intercambios de rostros con IA o retoques intensivos asistidos por IA

Autenticación

Sustituye {your-api-domain} por el endpoint de API mostrado en el panel de tu cuenta.

Autentica las solicitudes con el endpoint de API de tu cuenta y un token Bearer. Después de comprar créditos de API, puedes ver tu endpoint y token en el panel de tu cuenta. Mantén tu token en secreto y nunca lo subas a repositorios 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 Solicitud

Parámetro	Tipo	✓	Descripción
image	string	✓	Archivos de retrato compatibles de hasta 10 MB.

Ejemplo de Solicitud HTTP

{
  "image": "<BASE64_IMAGE_WITHOUT_PREFIX>"
}

Parámetros de respuesta

Parámetro	Tipo	Descripción
code	integer	Referencia para códigos de respuesta API
request_id	string	Use estos ejemplos para construir y depurar su integración
data.ai_generated	boolean \| null	Imagen facial probablemente generada o modificada sustancialmente por IA / No se detectó una señal fuerte de generación por IA
data.ai_generation_score	number \| null	Una puntuación más alta indica señales de generación por IA más fuertes en toda la imagen. Úsala como señal de revisión, no como prueba de que la imagen es real.
data.review_status	"likely_ai" \| "likely_not_ai" \| "review"	Se recomienda revisión
data.analysis_scope	"portrait"	Comprueba si un rostro parece real o generado por IA, incluidas señales de rostros sintéticos, intercambio de rostros con IA y retoques intensivos asistidos por IA. El modelo analiza toda la imagen y devuelve una puntuación de riesgo de generación por IA.

Ejemplos de Respuesta

{
  "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 Error

400INVALID_REQUESTLos API messages se muestran con sus valores brutos del servicio ascendente para coincidir exactamente con las respuestas de producción.

401INVALID_API_KEYLos API messages se muestran con sus valores brutos del servicio ascendente para coincidir exactamente con las respuestas de producción.

402CREDITS_EXHAUSTEDLos API messages se muestran con sus valores brutos del servicio ascendente para coincidir exactamente con las respuestas de producción.

403API_KEY_INACTIVE / API_KEY_EXPIREDLos API messages se muestran con sus valores brutos del servicio ascendente para coincidir exactamente con las respuestas de producción.

413PAYLOAD_TOO_LARGELos API messages se muestran con sus valores brutos del servicio ascendente para coincidir exactamente con las respuestas de producción.

415UNSUPPORTED_IMAGELos API messages se muestran con sus valores brutos del servicio ascendente para coincidir exactamente con las respuestas de producción.

502UPSTREAM_ERRORLos API messages se muestran con sus valores brutos del servicio ascendente para coincidir exactamente con las respuestas de producción.

504UPSTREAM_TIMEOUTLos API messages se muestran con sus valores brutos del servicio ascendente para coincidir exactamente con las respuestas de producción.

Ejemplos 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>"
}'