문서 사기 탐지 API

API 소개

위조 감지에 특화된 인공지능 기술이 ImgAuth.com API를 사용하여 그 어느 때보다 쉬워졌습니다. 몇 줄의 코드만으로 이 기술을 애플리케이션에 통합할 수 있습니다.

요청 매개변수: Base64로 인코딩한 이미지 데이터를 URL 인코딩해 전달합니다. 최대 10 MB. 짧은 변은 최소 512 px, 긴 변은 최대 8192 px입니다. jpg/jpeg/png/bmp를 지원합니다. image 또는 url 중 하나를 제공하세요.
응답 파라미터: API 응답 필드 참고

API 소개

재무팀의 송장 및 영수증 검토
HR팀의 증명서 및 스캔 기록 검토
보험팀의 청구 문서 검토

인증

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

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

POSThttps://api.imgauth.com/v1/document-fraud-detection

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

요청 매개변수

매개변수	유형	✓	설명
image	string	✓	Base64로 인코딩한 이미지 데이터를 URL 인코딩해 전달합니다. 최대 10 MB. 짧은 변은 최소 512 px, 긴 변은 최대 8192 px입니다. jpg/jpeg/png/bmp를 지원합니다. image 또는 url 중 하나를 제공하세요.
detect_proportion	boolean	—	위변조 신뢰도 점수 반환 여부입니다. 기본값은 false입니다. true면 점수를 반환하고 false면 반환하지 않습니다.
return_heatmap	boolean	—	위변조 히트맵 반환 여부입니다. 기본값은 false입니다. true면 Base64 히트맵을 반환하고 false면 반환하지 않습니다.
location	boolean	—	이 예제를 사용하여 통합을 구축하고 디버그하세요

샘플 HTTP 요청

{
  "image": "<BASE64_IMAGE_WITHOUT_PREFIX>",
  "detect_proportion": true,
  "return_heatmap": true,
  "location": true
}

응답 파라미터

파라미터	유형	설명
code	integer	API 응답 코드 참조
request_id	string	이 예제를 사용하여 통합을 구축하고 디버그하세요
data.detection_result	"fake" \| "real"	위변조 결과입니다. "fake"는 위변조 감지, "real"은 위변조 없음입니다.
data.tampered_proportion	number \| null	위변조 신뢰도 점수로, detect_proportion = true일 때 반환됩니다.
data.heatmap	string \| null	위변조 영역의 Base64 히트맵으로, return_heatmap = true일 때 반환됩니다.
data.tampered_location	array	probability가 restrict_probability 이상일 때 반환되는 의심 영역 좌표 배열입니다. 각 항목은 left, top, width, height, probability를 포함합니다.

샘플 응답

{
  "code": 0,
  "request_id": "req_01...",
  "data": {
    "detection_result": "fake",
    "tampered_proportion": 0.82,
    "heatmap": "<BASE64_HEATMAP>",
    "tampered_location": [
      { "left": 124, "top": 86, "width": 220, "height": 74, "probability": 0.91 }
    ]
  }
}

오류 코드

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/document-fraud-detection" \
  -H "Authorization: Bearer rh_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "image": "<BASE64_IMAGE_WITHOUT_PREFIX>",
  "detect_proportion": true,
  "return_heatmap": true,
  "location": true
}'