API do Wykrywania Fałszerstw Obrazów
Dostęp dla deweloperów
Wykrywaj manipulacje dokumentów i obrazów za pomocą gotowego do produkcji REST 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
Gdy żądanie jest poprawne, a obraz zostanie przetworzony pomyślnie, API zwraca detection_result, aby wskazać, czy obraz jest zmanipulowany (fake), czy autentyczny (real), a także — w razie potrzeby — poziom pewności, heatmapę i współrzędne.
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.
Wybierz kredyty API
Wybierz pakiet kredytów API odpowiedni do wolumenu integracji
Uzyskaj dostęp do API
Po zakupie zobaczysz klucz API i endpoint w panelu konta
Użyj Przykładów Kodu
Użyj następujących przykładów kodu, aby szybko zacząć
Uruchom produkcyjnie
Monitoruj użycie, dostosowuj parametry i przejdź do produkcji
Uwierzytelnianie
Uwierzytelniaj żądania za pomocą endpointu API swojego konta i tokenu Bearer. Po zakupie kredytów API możesz zobaczyć endpoint i token w panelu konta. Zachowaj token w tajemnicy i nigdy nie umieszczaj go w publicznych repozytoriach.
Punkt Końcowy API
Zastąp {your-api-domain} endpointem API pokazanym w panelu konta.
Nagłówki
Przykłady Kodu
Zacznij szybko z naszymi przykładami kodu
#!/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"Parametry Żądania
Skonfiguruj swoje żądania API za pomocą tych parametrów
| Parametr | Typ | Opis |
|---|---|---|
| image | string | Dane obrazu zakodowane w Base64, a następnie URL-encoded. Maksymalnie 10 MB. Krótszy bok co najmniej 512 px, dłuższy bok najwyżej 8192 px. Obsługuje jpg/jpeg/png/bmp. Podaj image lub url. |
| url | string | Pełny URL obrazu o długości do 1024 bajtów. Zakodowany obraz musi pozostać poniżej 10 MB. Krótszy bok co najmniej 512 px, dłuższy bok najwyżej 8192 px. Obsługuje jpg/jpeg/png/bmp. Podaj image lub url i wyłącz ochronę hotlink. |
| return_heatmap | string | Określa, czy zwrócić heatmapę fałszerstwa. Domyślnie: false. true zwraca heatmapę Base64, false jej nie zwraca. |
| detect_proportion | string | Określa, czy zwrócić poziom pewności manipulacji. Domyślnie: false. true zwraca wynik, false nie. |
| restrict_probability | string | Próg zwracania współrzędnych fałszerstwa. Zakres: 0.1 do 1 z 1 miejscem po przecinku. Domyślnie: 0.8. tampered_location jest zwracane tylko wtedy, gdy probability osiąga lub przekracza ten próg. |
Parametry odpowiedzi
Opis pól odpowiedzi API
| Parametr | Typ | Opis |
|---|---|---|
| detection_result | string | Wynik manipulacji: "fake" oznacza wykrytą manipulację, a "real" oznacza brak wykrytej manipulacji. |
| tampered_proportion | float | Poziom pewności manipulacji, zwracany gdy detect_proportion = true. |
| heatmap | string | Heatmapa Base64 zmanipulowanych obszarów, zwracana gdy return_heatmap = true. |
| tampered_location | array | Tablica współrzędnych podejrzanych obszarów, zwracana gdy probability jest większe lub równe restrict_probability. Każdy element zawiera left, top, width, height oraz probability. |
| left | uint32 | Pozioma współrzędna lewego górnego rogu podejrzanego obszaru. |
| top | uint32 | Pionowa współrzędna lewego górnego rogu podejrzanego obszaru. |
| width | uint32 | Szerokość podejrzanego obszaru. |
| height | uint32 | Wysokość podejrzanego obszaru. |
| probability | float | Poziom pewności dla tego podejrzanego obszaru. |
Kody Błędów
Referencja dla kodów odpowiedzi API
| Kod Błędu | Komunikat Błędu |
|---|---|
| 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 są wyświetlane jako surowe wartości usługi upstream, aby dokładnie odpowiadały odpowiedziom z produkcji.
Plany Cenowe API
Tańsze niż jednorazowe pakiety kredytów. Subskrypcje nadal są najtańszą opcją przy regularnym użyciu.
Deweloper
Najlepsze do oceny i wczesnej integracji
- Uwierzytelnianie tokenem Bearer
- Wynik fałszerstwa, poziom pewności, heatmapa i współrzędne obszaru
- Zaprojektowane do workflow przeglądu zmanipulowanych dokumentów i obrazów
- Dostęp do endpointu i tokenu w panelu po zakupie
Wzrost
Najlepsze do pilotaży produkcyjnych i stabilnego użycia
- Uwierzytelnianie tokenem Bearer
- Wynik fałszerstwa, poziom pewności, heatmapa i współrzędne obszaru
- Zaprojektowane do workflow przeglądu zmanipulowanych dokumentów i obrazów
- Dostęp do endpointu i tokenu w panelu po zakupie
Skala
Najlepsze do wsadów i zespołów z wieloma projektami
- Uwierzytelnianie tokenem Bearer
- Wynik fałszerstwa, poziom pewności, heatmapa i współrzędne obszaru
- Zaprojektowane do workflow przeglądu zmanipulowanych dokumentów i obrazów
- Dostęp do endpointu i tokenu w panelu po zakupie
Biznes
Najlepsze do długoterminowych obciążeń produkcyjnych
- Uwierzytelnianie tokenem Bearer
- Wynik fałszerstwa, poziom pewności, heatmapa i współrzędne obszaru
- Zaprojektowane do workflow przeglądu zmanipulowanych dokumentów i obrazów
- Dostęp do endpointu i tokenu w panelu po zakupie
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.
1 kredyt API = 1 żądanie API. Ceny API są niższe niż jednorazowych pakietów kredytów, a subskrypcje pozostają najbardziej ekonomiczną opcją do ciągłego użycia.