文件詐欺檢測 API

API 介紹

專門用於圖像偽造檢測的人工智慧技術透過使用ImgAuth.com API變得比以往任何時候都更容易。只需幾行程式碼，您就可以將此技術引入您的應用程式。

請求參數: Base64 編碼後的影像資料，需再進行 URL 編碼。最大 10 MB。最短邊至少 512 px，最長邊最多 8192 px。支援 jpg/jpeg/png/bmp。image 與 url 擇一提供。
回應參數: API 回應欄位說明

API 介紹

财务审核
人事审核
保险理赔审核

身份驗證

請將 {your-api-domain} 替換為帳戶儀表板中顯示的 API 端點。

使用帳戶中的 API 端點與 Bearer Token 進行驗證。購買 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
}'