API pro Detekci Falšování Obrázků
Přístup pro vývojáře
Odhalte manipulaci dokumentů a obrázků pomocí produkčně připraveného REST API.
Příklady požadavků a odpovědí
Použijte tyto příklady k vytvoření a ladění vaší integrace
Ukázkový HTTP požadavek
POST https://{your-api-domain}/forgery_detection
Hlavičky:
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"
}Ukázkové odpovědi
Úspěšná odpověď
Když je požadavek platný a obrázek je úspěšně zpracován, API vrací detection_result, aby ukázalo, zda je obrázek zmanipulovaný (fake), nebo autentický (real), a případně i míru jistoty, heatmapu a souřadnice.
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"
}Odpověď na obchodní chybu
Když nadřazená služba hlásí obchodní chybu, API vrátí chybu = "API_ERROR" a nenulový kód. Tento kód můžete mapovat pomocí tabulky chybových kódů níže.
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."
}Úvod do API
Technologie umělé inteligence specializovaná na detekci padělků byla díky API ImgAuth.com usnadněna více než kdy dříve. Pouhými několika řádky kódu můžete tuto technologii přinést do své aplikace.
Vyberte API kredity
Vyberte balíček API kreditů podle objemu vaší integrace
Získejte přístup k API
Po nákupu uvidíte svůj API klíč a endpoint v panelu účtu
Použít ukázky kódu
Použijte následující ukázky kódu pro rychlý start
Přejděte do produkce
Sledujte využití, upravujte parametry a přejděte do produkce
Ověření
Autentizujte požadavky pomocí API endpointu svého účtu a Bearer tokenu. Po zakoupení API kreditů můžete endpoint a token zobrazit v panelu účtu. Uchovávejte token v tajnosti a nikdy jej necommitujte do veřejných repozitářů.
API koncový bod
Nahraďte {your-api-domain} API endpointem zobrazeným v panelu účtu.
Hlavičky
Příklady kódu
Začněte rychle s našimi ukázkami kódu
#!/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 požadavku
Nakonfigurujte své API požadavky pomocí těchto parametrů
| Parametr | Typ | Popis |
|---|---|---|
| image | string | Obrazová data zakódovaná v Base64 a následně URL-encoded. Maximálně 10 MB. Kratší strana alespoň 512 px a delší strana nejvýše 8192 px. Podporuje jpg/jpeg/png/bmp. Zadejte image nebo url. |
| url | string | Úplná URL obrázku do 1024 bajtů. Zakódovaný obrázek musí zůstat pod 10 MB. Kratší strana alespoň 512 px a delší strana nejvýše 8192 px. Podporuje jpg/jpeg/png/bmp. Zadejte image nebo url a vypněte hotlink ochranu. |
| return_heatmap | string | Určuje, zda vrátit heatmapu padělání. Výchozí hodnota: false. true vrací Base64 heatmapu, false ji nevrací. |
| detect_proportion | string | Určuje, zda vrátit skóre jistoty manipulace. Výchozí hodnota: false. true vrací skóre, false ne. |
| restrict_probability | string | Prahová hodnota pro vrácení souřadnic padělání. Rozsah: 0.1 až 1 s 1 desetinným místem. Výchozí hodnota: 0.8. tampered_location se vrací pouze tehdy, když probability dosáhne nebo překročí práh. |
Parametry odpovědi
Reference polí odpovědi API
| Parametr | Typ | Popis |
|---|---|---|
| detection_result | string | Výsledek manipulace: "fake" znamená zjištěnou manipulaci, "real" znamená, že manipulace zjištěna nebyla. |
| tampered_proportion | float | Skóre jistoty manipulace, vrácené při detect_proportion = true. |
| heatmap | string | Base64 heatmapa manipulovaných oblastí, vrácená při return_heatmap = true. |
| tampered_location | array | Pole souřadnic podezřelých oblastí, vrácené pokud je probability větší nebo rovna restrict_probability. Každá položka obsahuje left, top, width, height a probability. |
| left | uint32 | Vodorovná souřadnice levého horního rohu podezřelé oblasti. |
| top | uint32 | Svislá souřadnice levého horního rohu podezřelé oblasti. |
| width | uint32 | Šířka podezřelé oblasti. |
| height | uint32 | Výška podezřelé oblasti. |
| probability | float | Skóre jistoty pro tuto podezřelou oblast. |
Chybové kódy
Referenční příručka pro kódy odpovědí API
| Chybový kód | Chybová zpráva |
|---|---|
| 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 se zobrazují jako surové hodnoty upstream služby, aby přesně odpovídaly odpovědím v produkci.
Cenové plány API
Levnější než jednorázové balíčky kreditů. Předplatná zůstávají nejlevnější možností pro opakované použití.
Vývojář
Nejlepší pro vyhodnocení a ranou integraci
- Ověření pomocí Bearer tokenu
- Výsledek padělání, míra jistoty, heatmapa a souřadnice oblasti
- Navrženo pro workflow kontroly manipulovaných dokumentů a obrázků
- Po nákupu jsou endpoint a token dostupné v dashboardu
Růst
Nejlepší pro produkční piloty a stabilní používání
- Ověření pomocí Bearer tokenu
- Výsledek padělání, míra jistoty, heatmapa a souřadnice oblasti
- Navrženo pro workflow kontroly manipulovaných dokumentů a obrázků
- Po nákupu jsou endpoint a token dostupné v dashboardu
Škála
Nejlepší pro dávkové workflow a týmy s více projekty
- Ověření pomocí Bearer tokenu
- Výsledek padělání, míra jistoty, heatmapa a souřadnice oblasti
- Navrženo pro workflow kontroly manipulovaných dokumentů a obrázků
- Po nákupu jsou endpoint a token dostupné v dashboardu
Business
Nejlepší pro dlouhodobé produkční zatížení
- Ověření pomocí Bearer tokenu
- Výsledek padělání, míra jistoty, heatmapa a souřadnice oblasti
- Navrženo pro workflow kontroly manipulovaných dokumentů a obrázků
- Po nákupu jsou endpoint a token dostupné v dashboardu
Proč vývojáři důvěřují našemu API
Vytvořené pro produkční zátěž, naše API pro detekci padělků vyvažuje kvalitu, výkon a náklady, takže se na něj můžete spolehnout v reálných aplikacích.
Produkčně připravená spolehlivost
Vysoká dostupnost a stabilní výkon optimalizovaný pro reálný provoz.
Optimalizováno pro detekci padělků
Modely zaměřené na dokumenty, certifikáty a faktury s detekcí manipulace pro konzistentnější výsledky.
Předvídatelné, pouze API cenění
Vyhrazené API plány s jasnými náklady na kredit pro dlouhodobé integrace.
Podpora, když ji potřebujete
E-mailová podpora, která vám pomůže diagnostikovat problémy a v průběhu času zlepšit vaši integraci.
1 API kredit = 1 API požadavek. Ceny API jsou nižší než u jednorázových balíčků kreditů, zatímco předplatná zůstávají nejúspornější možností pro průběžné používání.