실제 얼굴 또는 AI 얼굴 API

API 소개

얼굴이 실제인지 AI 생성으로 보이는지 합성 얼굴, AI 얼굴 교체, 과도한 AI 보조 보정 신호를 포함해 확인합니다. 모델은 전체 이미지를 분석하고 AI 생성 위험 점수를 반환합니다.

요청 매개변수: 최대 10MB의 지원되는 인물 이미지 파일.
응답 파라미터: 점수가 높을수록 이미지 전체의 AI 생성 신호가 강합니다. 검토 근거로 쓰고, 이미지가 진짜라는 증명으로 쓰지 마세요.

API 소개

프로필 사진이 실제인지 AI 생성인지 확인
셀카와 인물 사진의 합성 얼굴 신호 검토
가능한 AI 얼굴 교체 또는 과도한 AI 보조 보정 선별

인증

{your-api-domain}을 계정 대시보드에 표시된 API 엔드포인트로 바꾸세요.

계정의 API 엔드포인트와 Bearer 토큰으로 요청을 인증하세요. API 크레딧을 구매하면 대시보드에서 엔드포인트와 토큰을 확인할 수 있습니다. 토큰은 비밀로 유지하고 공개 저장소에 커밋하지 마세요.

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

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

요청 매개변수

매개변수	유형	✓	설명
image	string	✓	최대 10MB의 지원되는 인물 이미지 파일.

샘플 HTTP 요청

{
  "image": "<BASE64_IMAGE_WITHOUT_PREFIX>"
}

응답 파라미터

파라미터	유형	설명
code	integer	API 응답 코드 참조
request_id	string	이 예제를 사용하여 통합을 구축하고 디버그하세요
data.ai_generated	boolean \| null	AI로 생성되었거나 상당 부분 AI로 편집되었을 가능성이 높은 얼굴 이미지 / 강한 AI 생성 신호가 감지되지 않음
data.ai_generation_score	number \| null	점수가 높을수록 이미지 전체의 AI 생성 신호가 강합니다. 검토 근거로 쓰고, 이미지가 진짜라는 증명으로 쓰지 마세요.
data.review_status	"likely_ai" \| "likely_not_ai" \| "review"	검토 권장
data.analysis_scope	"portrait"	얼굴이 실제인지 AI 생성으로 보이는지 합성 얼굴, AI 얼굴 교체, 과도한 AI 보조 보정 신호를 포함해 확인합니다. 모델은 전체 이미지를 분석하고 AI 생성 위험 점수를 반환합니다.

샘플 응답

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

오류 코드

400INVALID_REQUESTAPI message는 실제 운영 응답과 정확히 맞추기 위해 상위 서비스의 원본 값을 그대로 표시합니다.

401INVALID_API_KEYAPI message는 실제 운영 응답과 정확히 맞추기 위해 상위 서비스의 원본 값을 그대로 표시합니다.

402CREDITS_EXHAUSTEDAPI message는 실제 운영 응답과 정확히 맞추기 위해 상위 서비스의 원본 값을 그대로 표시합니다.

403API_KEY_INACTIVE / API_KEY_EXPIREDAPI message는 실제 운영 응답과 정확히 맞추기 위해 상위 서비스의 원본 값을 그대로 표시합니다.

413PAYLOAD_TOO_LARGEAPI message는 실제 운영 응답과 정확히 맞추기 위해 상위 서비스의 원본 값을 그대로 표시합니다.

415UNSUPPORTED_IMAGEAPI message는 실제 운영 응답과 정확히 맞추기 위해 상위 서비스의 원본 값을 그대로 표시합니다.

502UPSTREAM_ERRORAPI message는 실제 운영 응답과 정확히 맞추기 위해 상위 서비스의 원본 값을 그대로 표시합니다.

504UPSTREAM_TIMEOUTAPI message는 실제 운영 응답과 정확히 맞추기 위해 상위 서비스의 원본 값을 그대로 표시합니다.

코드 예제

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