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. עם כמה שורות קוד בלבד, תוכל להביא את הטכנולוגיה הזו ליישום שלך.
בחרו קרדיטים ל-API
בחרו את חבילת הקרדיטים ל-API המתאימה לנפח האינטגרציה שלכם
קבלו גישת API
לאחר הרכישה תוכלו לראות את מפתח ה-API וה-endpoint בלוח הבקרה של החשבון
שימוש בדוגמאות קוד
השתמש בדוגמאות הקוד הבאות כדי להתחיל במהירות
עברו לייצור
עקבו אחרי השימוש, התאימו פרמטרים ועברו לייצור
אימות
אמתו בקשות באמצעות endpoint ה-API של החשבון שלכם וטוקן Bearer. לאחר רכישת קרדיטים ל-API תוכלו לראות את ה-endpoint והטוקן בלוח הבקרה של החשבון. שמרו על הטוקן בסוד ואל תבצעו לו commit למאגרים ציבוריים.
נקודת קצה API
החליפו את {your-api-domain} ב-endpoint ה-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-encode. מקסימום 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 ולכבות הגנת hotlink. |
| return_heatmap | string | קובע האם להחזיר heatmap של זיוף. ברירת מחדל: false. true מחזיר heatmap ב-Base64, false לא. |
| detect_proportion | string | קובע האם להחזיר את ציון הביטחון של המניפולציה. ברירת מחדל: false. true מחזיר את הציון, false לא. |
| restrict_probability | string | סף להחזרת קואורדינטות של זיוף. טווח: 0.1 עד 1 עם ספרה עשרונית אחת. ברירת מחדל: 0.8. tampered_location מוחזר רק כאשר probability מגיע או עולה על הסף. |
פרמטרי תגובה
מדריך לשדות תגובת API
| פרמטר | סוג | תיאור |
|---|---|---|
| detection_result | string | תוצאת המניפולציה: "fake" פירושו שזוהתה מניפולציה, ו-"real" פירושו שלא זוהתה מניפולציה. |
| tampered_proportion | float | ציון הביטחון של המניפולציה, מוחזר כאשר detect_proportion = true. |
| heatmap | string | Heatmap ב-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 messages מוצגים כערכי upstream גולמיים כדי להתאים בדיוק לתגובות הייצור.
תוכניות תמחור API
זול יותר מחבילות קרדיטים חד-פעמיות. מנויים נשארים האפשרות הזולה ביותר לשימוש חוזר.
מפתח
הכי מתאים להערכה ולאינטגרציה מוקדמת
- אימות באמצעות Bearer token
- תוצאת זיוף, רמת ביטחון, heatmap וקואורדינטות אזור
- מיועד לזרימות עבודה של בדיקת מסמכים ותמונות שעברו מניפולציה
- גישה ל-endpoint ול-token מהדשבורד לאחר הרכישה
צמיחה
הכי מתאים לפיילוטים בפרודקשן ולשימוש יציב
- אימות באמצעות Bearer token
- תוצאת זיוף, רמת ביטחון, heatmap וקואורדינטות אזור
- מיועד לזרימות עבודה של בדיקת מסמכים ותמונות שעברו מניפולציה
- גישה ל-endpoint ול-token מהדשבורד לאחר הרכישה
סקייל
הכי מתאים לזרימות עבודה באצווה ולצוותים מרובי פרויקטים
- אימות באמצעות Bearer token
- תוצאת זיוף, רמת ביטחון, heatmap וקואורדינטות אזור
- מיועד לזרימות עבודה של בדיקת מסמכים ותמונות שעברו מניפולציה
- גישה ל-endpoint ול-token מהדשבורד לאחר הרכישה
עסקי
הכי מתאים לעומסי עבודה ארוכי טווח בפרודקשן
- אימות באמצעות Bearer token
- תוצאת זיוף, רמת ביטחון, heatmap וקואורדינטות אזור
- מיועד לזרימות עבודה של בדיקת מסמכים ותמונות שעברו מניפולציה
- גישה ל-endpoint ול-token מהדשבורד לאחר הרכישה
למה מפתחים סומכים על ה-API שלנו
נבנה לעומסי עבודה בייצור, API זיהוי הזיופים שלנו מאזן איכות, ביצועים ועלות כך שתוכל לסמוך עליו באפליקציות אמיתיות.
אמינות מוכנה לייצור
זמינות גבוהה וביצועים יציבים מותאמים לתנועה אמיתית.
מותאם לזיהוי זיופים
מודלים המתמקדים במסמכים, תעודות וחשבוניות עם זיהוי מניפולציה לתוצאות עקביות יותר.
תמחור צפוי, API בלבד
תוכניות API ייעודיות עם עלויות ברורות לכל נקודת זכות לאינטגרציות ארוכות טווח.
תמיכה כשאתה צריך אותה
תמיכה באימייל כדי לעזור לך לאבחן בעיות ולשפר את האינטגרציה שלך לאורך זמן.
קרדיט API אחד = בקשת API אחת. תמחור ה-API נמוך יותר מחבילות קרדיטים חד-פעמיות, בעוד שמנויים נשארים האפשרות החסכונית ביותר לשימוש רציף.