Wykrywanie Fałszerstw Obrazów
API
Wykryj fałszerstwa w dowolnym obrazie za pomocą 1 wywołania API
Przykłady Żądań i Odpowiedzi
Użyj tych przykładów do budowania i debugowania integracji
Przykładowe Żądanie HTTP
POST https://{your-api-domain}/forgery_detection
Nagłówki:
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"
}Przykładowe Odpowiedzi
Sukces odpowiedzi
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"
}Odpowiedź błędu biznesowego
Gdy usługa upstream zgłasza błąd biznesowy, API zwraca błąd = "API_ERROR" i kod różny od zera. Możesz zmapować ten kod używając tabeli kodów błędów poniżej.
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."
}Wprowadzenie do API
Technologia sztucznej inteligencji specjalizująca się w wykrywaniu fałszerstw została ułatwiona bardziej niż kiedykolwiek dzięki użyciu API ImgAuth.com. Za pomocą zaledwie kilku linii kodu możesz wprowadzić tę technologię do swojej aplikacji.
Kup Pakiet
Kup pakiet dedykowany dla API
Otrzymaj Email API
W ciągu 2 godzin od zakupu otrzymasz email z dedykowaną domeną API i AppCode.
Użyj Przykładów Kodu
Użyj następujących przykładów kodu, aby szybko zacząć
Dostosuj Parametry
Wróć do referencji parametrów, aby dostosować żądanie
Uwierzytelnianie
Uwierzytelniamy żądania za pomocą dedykowanej domeny API i tokenu Bearer na konto. Po zakupie pakietu API wyślemy Ci email z unikalną domeną API i tokenem. Ze względów bezpieczeństwa prosimy nie publikować swojego tokenu API.
Punkt Końcowy API
Zastąp {your-api-domain} domeną API, którą wysyłamy Ci emailem po zakupie. Każdy deweloper ma dedykowaną domenę i token.
Nagłówki
Przykłady Kodu
Zacznij szybko z naszymi przykładami kodu
#!/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"Parametry Żądania
Skonfiguruj swoje żądania API za pomocą tych parametrów
| Parametr | Typ | Opis |
|---|---|---|
| image | string | Base64 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. |
| url | string | Complete 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_heatmap | string | Whether to return forgery region heatmap. Default: false. true: returns base64-encoded heatmap, false: does not return |
| detect_proportion | string | Whether to return image tampering confidence. Default: false. true: returns tampering confidence, false: does not return |
| restrict_probability | string | Threshold 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
| Parameter | Type | Description |
|---|---|---|
| detection_result | string | Tampering detection result: "fake" indicates tampering detected, "real" indicates no tampering |
| tampered_proportion | float | Image tampering confidence (returned when detect_proportion = true in request) |
| heatmap | string | Base64-encoded heatmap of tampered regions (returned when return_heatmap = true in request) |
| tampered_location | array | Array of forgery region coordinate information (returned when probability ≥ restrict_probability threshold). Each item contains: left, top, width, height (coordinates), and probability (confidence score) |
| left | uint32 | Horizontal coordinate of the top-left vertex of the forgery region |
| top | uint32 | Vertical coordinate of the top-left vertex of the forgery region |
| width | uint32 | Width of the forgery region |
| height | uint32 | Height of the forgery region |
| probability | float | Confidence score indicating the probability of forgery in this region |
Kody Błędów
Referencja dla kodów odpowiedzi API
| Kod Błędu | Komunikat Błędu | Opis |
|---|---|---|
| 0 | success | Success |
| 1000 | body error | Request body error |
| 1001 | param error | Request parameter error |
| 1002 | content type error | Content-Type error |
| 1003 | image not exists | Image file not found |
| 1004 | image size error | Image size error |
| 1005 | image format error | Image format error |
| 1006 | invalid signature | Invalid signature |
| 1007 | body size error | Body size error |
| 1008 | no authorization | Authorization failed |
| 2000 | server unknown error | Server unknown error |
| 2001 | server timeout | Server timeout |
| 2003 | no content recognition | No content recognized |
| 2004 | validate data error | Validation data error |
| 3000 | remote server error | Remote server error |
| 4000 | base server error | Base server error |
Plany Cenowe API
Następujące plany są wyłączne dla API
Starter
- Obsługuje większość formatów obrazów
- Korekta i ulepszanie dokumentów
- Wykrywanie fałszerstw dokumentów
- Usuwanie wzoru moiré z obrazu
- Prędkość przetwarzania ~2 sekundy
Popular
- Obsługuje większość formatów obrazów
- Korekta i ulepszanie dokumentów
- Wykrywanie fałszerstw dokumentów
- Usuwanie wzoru moiré z obrazu
- Prędkość przetwarzania ~2 sekundy
Business
- Obsługuje większość formatów obrazów
- Korekta i ulepszanie dokumentów
- Wykrywanie fałszerstw dokumentów
- Usuwanie wzoru moiré z obrazu
- Prędkość przetwarzania ~2 sekundy
Enterprise
- Obsługuje większość formatów obrazów
- Korekta i ulepszanie dokumentów
- Wykrywanie fałszerstw dokumentów
- Usuwanie wzoru moiré z obrazu
- Prędkość przetwarzania ~2 sekundy
Dlaczego deweloperzy ufają naszemu API
Zbudowane dla obciążeń produkcyjnych, nasze API wykrywania fałszerstw równoważy jakość, wydajność i koszt, dzięki czemu możesz na nim polegać w rzeczywistych aplikacjach.
Niezawodność gotowa do produkcji
Wysoka dostępność i stabilna wydajność dostosowana do rzeczywistego ruchu.
Zoptymalizowane do wykrywania fałszerstw
Modele skupione na dokumentach, certyfikatach i fakturach z wykrywaniem manipulacji dla bardziej spójnych wyników.
Przewidywalne, wyłącznie ceny API
Dedykowane plany API z jasnymi kosztami na kredyt dla długoterminowych integracji.
Wsparcie, gdy go potrzebujesz
Wsparcie e-mailowe, aby pomóc w diagnozowaniu problemów i poprawie integracji w czasie.