真人還是 AI 人臉 API

API 介紹

檢查人臉看起來是真實拍攝還是 AI 生成，包括合成臉、AI 換臉和重度 AI 輔助修圖跡象。模型分析整張圖片並返回 AI 生成風險分數。

請求參數: 支援 10 MB 以內的圖片檔案。
回應參數: 分數越高，整張圖片裡的 AI 生成訊號越強。把它當作複核依據，不要當成圖片真實的證明。

API 介紹

檢查頭像看起來是真實拍攝還是 AI 生成
檢查自拍和人像中的合成臉訊號
篩查可能的 AI 換臉或重度 AI 輔助修圖

檢查人臉看起來是真實拍攝還是 AI 生成，包括合成臉、AI 換臉和重度 AI 輔助修圖跡象。模型分析整張圖片並返回 AI 生成風險分數。

身份驗證

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

使用帳戶中的 API 端點與 Bearer Token 進行驗證。購買 API 點數後，可在帳戶儀表板查看端點與權杖。請妥善保管權杖，不要提交到公開儲存庫。

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

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

請求參數

參數	類型	✓	描述
image	string	✓	支援 10 MB 以內的圖片檔案。

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