요청 및 응답 예제
이 예제를 사용하여 통합을 구축하고 디버그하세요
샘플 HTTP 요청
POST https://{your-api-domain}/forgery_detection
헤더:
Authorization: Bearer {YOUR_API_TOKEN}
Content-Type: application/json; charset=UTF-8
Body:
{
"image": "<BASE64_IMAGE_WITHOUT_PREFIX>",
"return_heatmap": "false",
"detect_proportion": "false",
"restrict_probability": "0.8"
}샘플 응답
성공 응답
요청이 유효하고 이미지가 성공적으로 처리되면 API는 detection_result를 반환하여 이미지가 위변조됨(fake)인지 진짜(real)인지 알려주며, 필요 시 신뢰도, 히트맵, 좌표도 함께 반환합니다.
HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
{
"code": 0,
"data": {
"detection_result": "fake",
"tampered_proportion": 0.000587,
"heatmap": "<BASE64_HEATMAP_IMAGE>",
"tampered_location": [
{
"left": 100,
"top": 200,
"width": 150,
"height": 100,
"probability": 0.95
}
]
},
"message": "Success"
}비즈니스 오류 응답
업스트림 서비스가 비즈니스 오류를 보고하면 API는 오류 = "API_ERROR"와 0이 아닌 코드를 반환합니다. 아래 오류 코드 테이블을 사용하여 이 코드를 매핑할 수 있습니다.
HTTP/1.1 400 Bad Request
Content-Type: application/json; charset=UTF-8
{
"error": "API_ERROR",
"code": 1004,
"message": "Image size error. Please ensure the image is less than 5MB and the longest side is less than 4000px."
}API 소개
위조 감지에 특화된 인공지능 기술이 ImgAuth.com API를 사용하여 그 어느 때보다 쉬워졌습니다. 몇 줄의 코드만으로 이 기술을 애플리케이션에 통합할 수 있습니다.
API 크레딧 선택
통합 호출량에 맞는 API 크레딧 패키지를 선택하세요
API 액세스 받기
구매 후 계정 대시보드에서 API 키와 엔드포인트를 확인할 수 있습니다
코드 샘플 사용
다음 코드 샘플을 사용하여 빠르게 시작
프로덕션 적용
사용량을 모니터링하고 요청 파라미터를 조정한 뒤 프로덕션에 적용하세요
인증
계정의 API 엔드포인트와 Bearer 토큰으로 요청을 인증하세요. API 크레딧을 구매하면 대시보드에서 엔드포인트와 토큰을 확인할 수 있습니다. 토큰은 비밀로 유지하고 공개 저장소에 커밋하지 마세요.
API 엔드포인트
{your-api-domain}을 계정 대시보드에 표시된 API 엔드포인트로 바꾸세요.
헤더
코드 예제
코드 샘플로 빠르게 시작하세요
#!/usr/bin/env bash
set -euo pipefail
API_DOMAIN="https://{your-api-domain}"
API_PATH="/forgery_detection"
API_TOKEN="{YOUR_API_TOKEN}"
IMAGE_FILE="${1:-testpaper.jpg}"
BASE64_IMAGE=$(base64 -i "$IMAGE_FILE" | tr -d '
')
read -r -d '' JSON_BODY <<EOF || true
{
"image": "$BASE64_IMAGE",
"return_heatmap": "false",
"detect_proportion": "false",
"restrict_probability": "0.8"
}
EOF
curl -X POST "${API_DOMAIN}${API_PATH}" \
-H "Authorization: Bearer ${API_TOKEN}" \
-H "Content-Type: application/json; charset=UTF-8" \
-d "$JSON_BODY" \
-o response.json \
-s -w "\nHTTP status: %{http_code}\n"요청 매개변수
이 매개변수로 API 요청 구성
| 매개변수 | 유형 | 설명 |
|---|---|---|
| image | string | Base64로 인코딩한 이미지 데이터를 URL 인코딩해 전달합니다. 최대 10 MB. 짧은 변은 최소 512 px, 긴 변은 최대 8192 px입니다. jpg/jpeg/png/bmp를 지원합니다. image 또는 url 중 하나를 제공하세요. |
| url | string | 전체 이미지 URL로 최대 1024바이트입니다. 인코딩된 이미지 크기는 10 MB 이하여야 합니다. 짧은 변은 최소 512 px, 긴 변은 최대 8192 px입니다. jpg/jpeg/png/bmp를 지원합니다. image 또는 url 중 하나를 제공하고, 핫링크 보호를 해제하세요. |
| return_heatmap | string | 위변조 히트맵 반환 여부입니다. 기본값은 false입니다. true면 Base64 히트맵을 반환하고 false면 반환하지 않습니다. |
| detect_proportion | string | 위변조 신뢰도 점수 반환 여부입니다. 기본값은 false입니다. true면 점수를 반환하고 false면 반환하지 않습니다. |
| restrict_probability | string | 위변조 좌표를 반환하는 임계값입니다. 범위는 0.1~1이며 소수점 한 자리까지 지원합니다. 기본값은 0.8입니다. probability가 이 값 이상일 때만 tampered_location이 반환됩니다. |
응답 파라미터
API 응답 필드 참고
| 파라미터 | 유형 | 설명 |
|---|---|---|
| detection_result | string | 위변조 결과입니다. "fake"는 위변조 감지, "real"은 위변조 없음입니다. |
| tampered_proportion | float | 위변조 신뢰도 점수로, detect_proportion = true일 때 반환됩니다. |
| heatmap | string | 위변조 영역의 Base64 히트맵으로, return_heatmap = true일 때 반환됩니다. |
| tampered_location | array | probability가 restrict_probability 이상일 때 반환되는 의심 영역 좌표 배열입니다. 각 항목은 left, top, width, height, probability를 포함합니다. |
| left | uint32 | 의심 영역 좌상단의 가로 좌표. |
| top | uint32 | 의심 영역 좌상단의 세로 좌표. |
| width | uint32 | 의심 영역의 너비. |
| height | uint32 | 의심 영역의 높이. |
| probability | float | 해당 의심 영역의 신뢰도 점수. |
오류 코드
API 응답 코드 참조
| 오류 코드 | 오류 메시지 |
|---|---|
| 0 | success |
| 1000 | body error |
| 1001 | param error |
| 1002 | content type error |
| 1003 | image not exists |
| 1004 | image size error |
| 1005 | image format error |
| 1006 | invalid signature |
| 1007 | body size error |
| 1008 | no authorization |
| 2000 | server unknown error |
| 2001 | server timeout |
| 2003 | no content recognition |
| 2004 | validate data error |
| 3000 | remote server error |
| 4000 | base server error |
API message는 실제 운영 응답과 정확히 맞추기 위해 상위 서비스의 원본 값을 그대로 표시합니다.
API 가격 플랜
일회성 크레딧보다 저렴하며, 반복 사용에는 구독이 가장 비용 효율적입니다.
개발자
평가 및 초기 통합에 적합
- Bearer 토큰 인증
- 위변조 결과, 신뢰도, 히트맵, 영역 좌표 반환
- 문서 및 이미지 위변조 검토 워크플로에 맞게 설계됨
- 구매 후 대시보드에서 endpoint와 token 확인 가능
성장
프로덕션 파일럿과 안정적 사용에 적합
- Bearer 토큰 인증
- 위변조 결과, 신뢰도, 히트맵, 영역 좌표 반환
- 문서 및 이미지 위변조 검토 워크플로에 맞게 설계됨
- 구매 후 대시보드에서 endpoint와 token 확인 가능
확장
배치 워크플로와 다중 프로젝트 팀에 적합
- Bearer 토큰 인증
- 위변조 결과, 신뢰도, 히트맵, 영역 좌표 반환
- 문서 및 이미지 위변조 검토 워크플로에 맞게 설계됨
- 구매 후 대시보드에서 endpoint와 token 확인 가능
비즈니스
장기 프로덕션 워크로드에 적합
- Bearer 토큰 인증
- 위변조 결과, 신뢰도, 히트맵, 영역 좌표 반환
- 문서 및 이미지 위변조 검토 워크플로에 맞게 설계됨
- 구매 후 대시보드에서 endpoint와 token 확인 가능
개발자가 우리 API를 신뢰하는 이유
프로덕션 워크로드를 위해 구축된 우리의 위조 감지 API는 품질, 성능 및 비용의 균형을 맞춰 실제 애플리케이션에서 신뢰할 수 있습니다.
프로덕션 준비 신뢰성
실제 트래픽에 최적화된 높은 가용성과 안정적인 성능.
위조 감지에 최적화
더 일관된 결과를 위해 조작 감지 기능이 있는 문서, 인증서 및 청구서에 중점을 둔 모델.
예측 가능한 API 전용 가격
장기 통합을 위한 명확한 크레딧당 비용이 있는 전용 API 플랜.
필요할 때 지원
문제를 진단하고 시간이 지남에 따라 통합을 개선하는 데 도움이 되는 이메일 지원.
1 API 크레딧 = 1 API 요청. API 가격은 일회성 크레딧 팩보다 낮고, 지속적인 사용에는 구독이 가장 경제적입니다.