كشف تزوير الصور
API

اكتشف التزوير في أي صورة باستدعاء API واحد

أمثلة الطلب والاستجابة

استخدم هذه الأمثلة لبناء وتصحيح التكامل الخاص بك

مثال طلب 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"
}

أمثلة الاستجابة

استجابة ناجحة

When the request is valid and the image is processed successfully, the API returns detection_result indicating whether the image is tampered (fake) or authentic (real), along with optional tampering confidence, heatmap, and location coordinates.

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" ورمز غير صفري. يمكنك تعيين هذا الرمز باستخدام جدول رموز الخطأ أدناه.

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

أصبحت تقنية الذكاء الاصطناعي المتخصصة في كشف التزوير أسهل من أي وقت مضى باستخدام API الخاص بـ ImgAuth.com. ببضعة أسطر من الكود فقط، يمكنك إحضار هذه التقنية إلى تطبيقك.

1

شراء الحزمة

شراء حزمة مخصصة لـ API

2

استلام بريد الـ API

خلال ساعتين من إتمام عملية الشراء، ستتلقى رسالة بريد إلكتروني تحتوي على نطاق الـ API المخصص ورمز AppCode الخاص بك.

3

استخدام أمثلة الكود

استخدم أمثلة الكود التالية للبدء بسرعة

4

تعديل المعاملات

العودة إلى مرجع المعاملات لتعديل الطلب

المصادقة

نقوم بمصادقة الطلبات باستخدام نطاق API مخصص ورمز Bearer لكل حساب. بعد شراء حزمة API، سنرسل لك نطاق API الفريد ورمز الوصول الخاص بك. لأسباب أمنية، يرجى عدم نشر رمز API الخاص بك.

نقطة نهاية API

POST https://{your-api-domain}/forgery_detection

استبدل {your-api-domain} بنطاق API الذي نرسله إليك بعد الشراء. كل مطور لديه نطاق ورمز مخصص.

الرؤوس

التفويض:
Bearer {YOUR_API_TOKEN}
استبدل {YOUR_API_TOKEN} برمز Bearer الذي نرسله إليك. احتفظ به سراً ولا تلتزم به في المستودعات العامة.
نوع المحتوى:
application/json; charset=UTF-8

أمثلة الكود

ابدأ بسرعة مع أمثلة الكود الخاصة بنا

#!/usr/bin/env bash

set -euo pipefail

# Domain and token for the image processing proxy
API_DOMAIN="https://{your-api-domain}"
API_PATH="/forgery_detection"
API_TOKEN="{YOUR_API_TOKEN}"

# Image file passed as first argument (default: testpaper.jpg)
IMAGE_FILE="${1:-testpaper.jpg}"

if [ ! -f "$IMAGE_FILE" ]; then
  echo "Image file not found: $IMAGE_FILE" >&2
  echo "Usage: $0 path/to/image.jpg" >&2
  exit 1
fi

echo "Encoding image to Base64: $IMAGE_FILE"
# Encode image to Base64 and remove newlines (use -i for BSD base64 on macOS)
BASE64_IMAGE=$(base64 -i "$IMAGE_FILE" | tr -d '
')

echo "Building JSON body..."
read -r -d '' JSON_BODY <<EOF || true
{
  "image": "$BASE64_IMAGE",
  "return_heatmap": "false",
  "detect_proportion": "false",
  "restrict_probability": "0.8"
}
EOF

echo "Calling proxy API..."
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"

echo "Response saved to response.json"

معاملات الطلب

قم بتكوين طلبات API الخاصة بك باستخدام هذه المعاملات

المعاملالنوعالوصف
imagestringBase64 encoded image data, urlencoded. Size must not exceed 10MB. Shortest side at least 512px, longest side max 8192px. Supports jpg/jpeg/png/bmp formats. Either image or url is required.
urlstringComplete image URL, length not exceeding 1024 bytes. Image size must not exceed 10MB after base64 encoding. Shortest side at least 512px, longest side max 8192px. Supports jpg/jpeg/png/bmp formats. Either image or url is required. Please disable URL hotlink protection.
return_heatmapstringWhether to return forgery region heatmap. Default: false. true: returns base64-encoded heatmap, false: does not return
detect_proportionstringWhether to return image tampering confidence. Default: false. true: returns tampering confidence, false: does not return
restrict_probabilitystringThreshold for returning forgery region coordinates. Range: 0.1 to 1, supports 1 decimal place. Default: 0.8. When forgery region coordinate confidence score (probability) ≥ threshold, tampered_location returns coordinates meeting the threshold, otherwise does not return coordinates

Response Parameters

Reference for API response fields

ParameterTypeDescription
detection_resultstringTampering detection result: "fake" indicates tampering detected, "real" indicates no tampering
tampered_proportionfloatImage tampering confidence (returned when detect_proportion = true in request)
heatmapstringBase64-encoded heatmap of tampered regions (returned when return_heatmap = true in request)
tampered_locationarrayArray of forgery region coordinate information (returned when probability ≥ restrict_probability threshold). Each item contains: left, top, width, height (coordinates), and probability (confidence score)
leftuint32Horizontal coordinate of the top-left vertex of the forgery region
topuint32Vertical coordinate of the top-left vertex of the forgery region
widthuint32Width of the forgery region
heightuint32Height of the forgery region
probabilityfloatConfidence score indicating the probability of forgery in this region

رموز الخطأ

مرجع لرموز استجابة API

رمز الخطأرسالة الخطأالوصف
0successSuccess
1000body errorRequest body error
1001param errorRequest parameter error
1002content type errorContent-Type error
1003image not existsImage file not found
1004image size errorImage size error
1005image format errorImage format error
1006invalid signatureInvalid signature
1007body size errorBody size error
1008no authorizationAuthorization failed
2000server unknown errorServer unknown error
2001server timeoutServer timeout
2003no content recognitionNo content recognized
2004validate data errorValidation data error
3000remote server errorRemote server error
4000base server errorBase server error

خطط تسعير API

الخطط التالية حصرية لـ API

Starter

$99$0.198 / رصيد
500 رصيد
صالح لمدة 3 أشهر
  • دعم معظم تنسيقات الصور
  • تصحيح المستندات وتحسينها
  • كشف تزوير المستندات
  • إزالة نمط مواريه الصورة
  • سرعة المعالجة ~2 ثانية
الأكثر شعبية

Popular

$349$0.07 / رصيد
5,000 رصيد
صالح لمدة 6 أشهر
  • دعم معظم تنسيقات الصور
  • تصحيح المستندات وتحسينها
  • كشف تزوير المستندات
  • إزالة نمط مواريه الصورة
  • سرعة المعالجة ~2 ثانية

Business

$749$0.05 / رصيد
15,000 رصيد
صالح لمدة سنة واحدة
  • دعم معظم تنسيقات الصور
  • تصحيح المستندات وتحسينها
  • كشف تزوير المستندات
  • إزالة نمط مواريه الصورة
  • سرعة المعالجة ~2 ثانية
حصري

Enterprise

$1999$0.04 / رصيد
50,000 رصيد
صالح لمدة سنة واحدة
  • دعم معظم تنسيقات الصور
  • تصحيح المستندات وتحسينها
  • كشف تزوير المستندات
  • إزالة نمط مواريه الصورة
  • سرعة المعالجة ~2 ثانية

لماذا يثق المطورون بـ API الخاص بنا

مبني لأحمال عمل الإنتاج، يوازن API كشف التزوير الخاص بنا الجودة والأداء والتكلفة حتى تتمكن من الاعتماد عليه في التطبيقات الواقعية.

موثوقية جاهزة للإنتاج

توفر عالي وأداء مستقر محسّن لحركة المرور الواقعية.

محسّن لكشف التزوير

نماذج تركز على المستندات والشهادات والفواتير مع كشف التلاعب للحصول على نتائج أكثر اتساقاً.

تسعير متوقع، API فقط

خطط API مخصصة مع تكاليف واضحة لكل رصيد للتكاملات طويلة الأجل.

الدعم عندما تحتاجه

دعم عبر البريد الإلكتروني لمساعدتك في تشخيص المشكلات وتحسين التكامل الخاص بك بمرور الوقت.

واجهة برمجة تطبيقات كشف تزوير الصور – اكتشف العبث بالذكاء الاصطناعي