API לזיהוי זיוף תמונות
גישה למפתחים

זהו מניפולציה במסמכים ובתמונות באמצעות REST 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"
}

דוגמאות תגובה

תגובה מוצלחת

כאשר הבקשה תקינה והתמונה עוברת עיבוד בהצלחה, ה-API מחזיר detection_result כדי לציין אם התמונה מזויפת (fake) או אותנטית (real), יחד עם רמת ביטחון, heatmap וקואורדינטות בעת הצורך.

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

בחרו את חבילת הקרדיטים ל-API המתאימה לנפח האינטגרציה שלכם

2

קבלו גישת API

לאחר הרכישה תוכלו לראות את מפתח ה-API וה-endpoint בלוח הבקרה של החשבון

3

שימוש בדוגמאות קוד

השתמש בדוגמאות הקוד הבאות כדי להתחיל במהירות

4

עברו לייצור

עקבו אחרי השימוש, התאימו פרמטרים ועברו לייצור

אימות

אמתו בקשות באמצעות endpoint ה-API של החשבון שלכם וטוקן Bearer. לאחר רכישת קרדיטים ל-API תוכלו לראות את ה-endpoint והטוקן בלוח הבקרה של החשבון. שמרו על הטוקן בסוד ואל תבצעו לו commit למאגרים ציבוריים.

נקודת קצה API

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

החליפו את {your-api-domain} ב-endpoint ה-API שמופיע בלוח הבקרה של החשבון.

כותרות

הרשאה:
Bearer {YOUR_API_TOKEN}
החליפו את {YOUR_API_TOKEN} בטוקן Bearer שמופיע בלוח הבקרה של החשבון. שמרו עליו בסוד ואל תבצעו לו commit למאגרים ציבוריים.
Content-Type:
application/json; charset=UTF-8

דוגמאות קוד

התחל במהירות עם דוגמאות הקוד שלנו

#!/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 שלך עם הפרמטרים האלה

פרמטרסוגתיאור
imagestringנתוני תמונה המקודדים ב-Base64 ולאחר מכן ב-URL-encode. מקסימום 10 MB. הצד הקצר לפחות 512 px והצד הארוך לכל היותר 8192 px. תומך ב-jpg/jpeg/png/bmp. יש לספק image או url.
urlstringURL מלא של התמונה עד 1024 בתים. התמונה המקודדת חייבת להישאר מתחת ל-10 MB. הצד הקצר לפחות 512 px והצד הארוך לכל היותר 8192 px. תומך ב-jpg/jpeg/png/bmp. יש לספק image או url ולכבות הגנת hotlink.
return_heatmapstringקובע האם להחזיר heatmap של זיוף. ברירת מחדל: false. true מחזיר heatmap ב-Base64, false לא.
detect_proportionstringקובע האם להחזיר את ציון הביטחון של המניפולציה. ברירת מחדל: false. true מחזיר את הציון, false לא.
restrict_probabilitystringסף להחזרת קואורדינטות של זיוף. טווח: 0.1 עד 1 עם ספרה עשרונית אחת. ברירת מחדל: 0.8. tampered_location מוחזר רק כאשר probability מגיע או עולה על הסף.

פרמטרי תגובה

מדריך לשדות תגובת API

פרמטרסוגתיאור
detection_resultstringתוצאת המניפולציה: "fake" פירושו שזוהתה מניפולציה, ו-"real" פירושו שלא זוהתה מניפולציה.
tampered_proportionfloatציון הביטחון של המניפולציה, מוחזר כאשר detect_proportion = true.
heatmapstringHeatmap ב-Base64 של האזורים שעברו מניפולציה, מוחזר כאשר return_heatmap = true.
tampered_locationarrayמערך קואורדינטות של אזורים חשודים, מוחזר כאשר probability גדול או שווה ל-restrict_probability. כל פריט כולל left, top, width, height ו-probability.
leftuint32הקואורדינטה האופקית של הפינה השמאלית העליונה של האזור החשוד.
topuint32הקואורדינטה האנכית של הפינה השמאלית העליונה של האזור החשוד.
widthuint32רוחב האזור החשוד.
heightuint32גובה האזור החשוד.
probabilityfloatציון הביטחון עבור אזור חשוד זה.

קודי שגיאה

הפנייה לקודי תגובת API

קוד שגיאההודעת שגיאה
0success
1000body error
1001param error
1002content type error
1003image not exists
1004image size error
1005image format error
1006invalid signature
1007body size error
1008no authorization
2000server unknown error
2001server timeout
2003no content recognition
2004validate data error
3000remote server error
4000base server error

API messages מוצגים כערכי upstream גולמיים כדי להתאים בדיוק לתגובות הייצור.

תוכניות תמחור API

זול יותר מחבילות קרדיטים חד-פעמיות. מנויים נשארים האפשרות הזולה ביותר לשימוש חוזר.

מפתח

$99
500 קרדיטים
בתוקף ל-12 חודשים

הכי מתאים להערכה ולאינטגרציה מוקדמת

  • אימות באמצעות Bearer token
  • תוצאת זיוף, רמת ביטחון, heatmap וקואורדינטות אזור
  • מיועד לזרימות עבודה של בדיקת מסמכים ותמונות שעברו מניפולציה
  • גישה ל-endpoint ול-token מהדשבורד לאחר הרכישה
הפופולרי ביותר

צמיחה

$359
2,000 קרדיטים
בתוקף ל-12 חודשים

הכי מתאים לפיילוטים בפרודקשן ולשימוש יציב

  • אימות באמצעות Bearer token
  • תוצאת זיוף, רמת ביטחון, heatmap וקואורדינטות אזור
  • מיועד לזרימות עבודה של בדיקת מסמכים ותמונות שעברו מניפולציה
  • גישה ל-endpoint ול-token מהדשבורד לאחר הרכישה

סקייל

$899
5,000 קרדיטים
בתוקף ל-12 חודשים

הכי מתאים לזרימות עבודה באצווה ולצוותים מרובי פרויקטים

  • אימות באמצעות Bearer token
  • תוצאת זיוף, רמת ביטחון, heatmap וקואורדינטות אזור
  • מיועד לזרימות עבודה של בדיקת מסמכים ותמונות שעברו מניפולציה
  • גישה ל-endpoint ול-token מהדשבורד לאחר הרכישה
הערך הטוב ביותר

עסקי

$2,499
15,000 קרדיטים
בתוקף ל-12 חודשים

הכי מתאים לעומסי עבודה ארוכי טווח בפרודקשן

  • אימות באמצעות Bearer token
  • תוצאת זיוף, רמת ביטחון, heatmap וקואורדינטות אזור
  • מיועד לזרימות עבודה של בדיקת מסמכים ותמונות שעברו מניפולציה
  • גישה ל-endpoint ול-token מהדשבורד לאחר הרכישה

למה מפתחים סומכים על ה-API שלנו

נבנה לעומסי עבודה בייצור, API זיהוי הזיופים שלנו מאזן איכות, ביצועים ועלות כך שתוכל לסמוך עליו באפליקציות אמיתיות.

אמינות מוכנה לייצור

זמינות גבוהה וביצועים יציבים מותאמים לתנועה אמיתית.

מותאם לזיהוי זיופים

מודלים המתמקדים במסמכים, תעודות וחשבוניות עם זיהוי מניפולציה לתוצאות עקביות יותר.

תמחור צפוי, API בלבד

תוכניות API ייעודיות עם עלויות ברורות לכל נקודת זכות לאינטגרציות ארוכות טווח.

תמיכה כשאתה צריך אותה

תמיכה באימייל כדי לעזור לך לאבחן בעיות ולשפר את האינטגרציה שלך לאורך זמן.

קרדיט API אחד = בקשת API אחת. תמחור ה-API נמוך יותר מחבילות קרדיטים חד-פעמיות, בעוד שמנויים נשארים האפשרות החסכונית ביותר לשימוש רציף.