Görüntü Sahteciliği Tespit API’si
Geliştirici Erişimi
Üretime hazır bir REST API ile belge ve görüntü tahrifatını tespit edin.
İstek ve Yanıt Örnekleri
Entegrasyonunuzu oluşturmak ve hata ayıklamak için bu örnekleri kullanın
Örnek HTTP İsteği
POST https://{your-api-domain}/forgery_detection
Başlıklar:
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"
}Örnek Yanıtlar
Başarılı yanıt
İstek geçerli olduğunda ve görsel başarıyla işlendiğinde API, görselin tahrif edilmiş (fake) mi yoksa gerçek (real) mi olduğunu göstermek için detection_result döndürür; ayrıca istenirse güven skoru, heatmap ve koordinatlar da döndürülür.
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"
}İş hatası yanıtı
Yukarı akış hizmeti bir iş hatası bildirdiğinde, API hata = "API_ERROR" ve sıfır olmayan bir kod döndürür. Bu kodu aşağıdaki hata kodu tablosunu kullanarak eşleyebilirsiniz.
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 Giriş
Sahtecilik tespitinde uzmanlaşmış yapay zeka teknolojisi, ImgAuth.com API'sini kullanarak her zamankinden daha kolay hale getirildi. Sadece birkaç satır kodla bu teknolojiyi uygulamanıza getirebilirsiniz.
API Kredilerini Seçin
Entegrasyon hacminize uygun API kredi paketini seçin
API Erişimi Alın
Satın aldıktan sonra API anahtarınızı ve uç noktanızı hesap panelinde görüntüleyin
Kod Örneklerini Kullan
Hızlı başlamak için aşağıdaki kod örneklerini kullanın
Canlıya Geçin
Kullanımı izleyin, parametreleri ayarlayın ve üretime geçin
Kimlik Doğrulama
İstekleri hesap API uç noktanız ve Bearer token ile doğrulayın. API kredilerini satın aldıktan sonra uç noktanızı ve token’ınızı hesap panelinde görebilirsiniz. Token’ınızı gizli tutun ve asla herkese açık depolara göndermeyin.
API Uç Noktası
{your-api-domain} değerini hesap panelinizde gösterilen API uç noktasıyla değiştirin.
Başlıklar
Kod Örnekleri
Kod örneklerimizle hızlı başlayın
#!/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"İstek Parametreleri
API isteklerinizi bu parametrelerle yapılandırın
| Parametre | Tür | Açıklama |
|---|---|---|
| image | string | Base64 ile kodlanmış görsel verisi, ardından URL-encode edilir. En fazla 10 MB. En kısa kenar en az 512 px, en uzun kenar en fazla 8192 px olmalıdır. jpg/jpeg/png/bmp desteklenir. image veya url gönderin. |
| url | string | Tam görsel URL’si, en fazla 1024 bayt. Kodlanmış görsel 10 MB altında kalmalıdır. En kısa kenar en az 512 px, en uzun kenar en fazla 8192 px olmalıdır. jpg/jpeg/png/bmp desteklenir. image veya url gönderin ve hotlink korumasını kapatın. |
| return_heatmap | string | Sahtecilik heatmap’inin döndürülüp döndürülmeyeceğini belirtir. Varsayılan: false. true Base64 heatmap döndürür, false döndürmez. |
| detect_proportion | string | Tahrifat güven skorunun döndürülüp döndürülmeyeceğini belirtir. Varsayılan: false. true skoru döndürür, false döndürmez. |
| restrict_probability | string | Sahtecilik koordinatlarını döndürme eşiği. Aralık: 0.1 ile 1, 1 ondalık basamak. Varsayılan: 0.8. tampered_location yalnızca probability bu eşiğe ulaştığında veya aştığında döndürülür. |
Yanıt parametreleri
API yanıt alanları referansı
| Parametre | Tür | Açıklama |
|---|---|---|
| detection_result | string | Tahrifat sonucu: "fake" tahrifat tespit edildiğini, "real" ise tahrifat tespit edilmediğini gösterir. |
| tampered_proportion | float | Tahrifat güven skoru, detect_proportion = true olduğunda döndürülür. |
| heatmap | string | Tahrif edilmiş bölgelerin Base64 heatmap’i, return_heatmap = true olduğunda döndürülür. |
| tampered_location | array | Şüpheli bölge koordinatları dizisi, probability restrict_probability değerine eşit veya büyük olduğunda döndürülür. Her öğe left, top, width, height ve probability içerir. |
| left | uint32 | Şüpheli bölgenin sol üst köşesinin yatay koordinatı. |
| top | uint32 | Şüpheli bölgenin sol üst köşesinin dikey koordinatı. |
| width | uint32 | Şüpheli bölgenin genişliği. |
| height | uint32 | Şüpheli bölgenin yüksekliği. |
| probability | float | Bu şüpheli bölge için güven skoru. |
Hata Kodları
API yanıt kodları için referans
| Hata Kodu | Hata Mesajı |
|---|---|
| 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 üretimdeki yanıtlarla tam eşleşmesi için upstream servisin ham değerleri olarak gösterilir.
API Fiyatlandırma Planları
Tek seferlik kredi paketlerinden daha uygundur. Abonelikler düzenli kullanım için hâlâ en düşük maliyetli seçenektir.
Geliştirici
Değerlendirme ve ilk entegrasyon için ideal
- Bearer token kimlik doğrulaması
- Sahtecilik sonucu, güven skoru, heatmap ve bölge koordinatları
- Tahrif edilmiş belge ve görsellerin inceleme iş akışları için tasarlandı
- Satın alma sonrası panelden endpoint ve token erişimi
Büyüme
Üretim pilotları ve istikrarlı kullanım için ideal
- Bearer token kimlik doğrulaması
- Sahtecilik sonucu, güven skoru, heatmap ve bölge koordinatları
- Tahrif edilmiş belge ve görsellerin inceleme iş akışları için tasarlandı
- Satın alma sonrası panelden endpoint ve token erişimi
Ölçek
Toplu iş akışları ve çok projeli ekipler için ideal
- Bearer token kimlik doğrulaması
- Sahtecilik sonucu, güven skoru, heatmap ve bölge koordinatları
- Tahrif edilmiş belge ve görsellerin inceleme iş akışları için tasarlandı
- Satın alma sonrası panelden endpoint ve token erişimi
İş
Uzun vadeli üretim iş yükleri için ideal
- Bearer token kimlik doğrulaması
- Sahtecilik sonucu, güven skoru, heatmap ve bölge koordinatları
- Tahrif edilmiş belge ve görsellerin inceleme iş akışları için tasarlandı
- Satın alma sonrası panelden endpoint ve token erişimi
Geliştiriciler neden API'mize güveniyor
Üretim iş yükleri için oluşturulmuş, sahtecilik tespit API'miz kalite, performans ve maliyeti dengeler, böylece gerçek uygulamalarda buna güvenebilirsiniz.
Üretime hazır güvenilirlik
Gerçek trafik için ayarlanmış yüksek kullanılabilirlik ve kararlı performans.
Sahtecilik tespiti için optimize edilmiş
Daha tutarlı sonuçlar için tahrifat tespiti ile belgeler, sertifikalar ve faturalara odaklanan modeller.
Öngörülebilir, yalnızca API fiyatlandırması
Uzun vadeli entegrasyonlar için kredi başına net maliyetlerle özel API planları.
İhtiyacınız olduğunda destek
Sorunları teşhis etmenize ve entegrasyonunuzu zamanla iyileştirmenize yardımcı olmak için e-posta desteği.
1 API kredisi = 1 API isteği. API fiyatlandırması tek seferlik kredi paketlerinden daha düşüktür; sürekli kullanımda ise abonelikler en ekonomik seçenektir.