Kuvaväärennösten Tunnistus-API
Kehittäjäkäyttö
Havaitse asiakirjojen ja kuvien manipulointi tuotantovalmiilla REST API:lla.
Pyyntö- ja Vastausesimerkit
Käytä näitä esimerkkejä rakentaaksesi ja debugataksesi integraatiosi
Esimerkki HTTP-pyyntö
POST https://{your-api-domain}/forgery_detection
Otsakkeet:
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"
}Esimerkki vastaukset
Onnistunut vastaus
Kun pyyntö on kelvollinen ja kuva käsitellään onnistuneesti, API palauttaa detection_result-kentän näyttääkseen, onko kuva manipuloitu (fake) vai aito (real), sekä tarvittaessa luottamusarvon, heatmapin ja koordinaatit.
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"
}Liiketoimintavirheen vastaus
Kun ylävirran palvelu raportoi liiketoimintavirheen, API palauttaa virheen = "API_ERROR" ja nollasta poikkeavan koodin. Voit kartoittaa tämän koodin käyttämällä alla olevaa virhekooditaulukkoa.
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 Johdanto
Tekoälyteknologia, joka on erikoistunut kuvaväärennösten havaitsemiseen, on tehty helpommaksi kuin koskaan ImgAuth.com API:n avulla. Vain muutamalla koodirivillä voit tuoda tämän teknologian sovellukseesi.
Valitse API-krediitit
Valitse integraatiomäärääsi sopiva API-krediittipaketti
Hanki API-käyttöoikeus
Oston jälkeen näet API-avaimesi ja päätepisteesi tilisi hallintapaneelissa
Käytä Koodiesimerkkejä
Käytä seuraavia koodiesimerkkejä aloittaaksesi nopeasti
Siirry tuotantoon
Seuraa käyttöä, säädä parametreja ja siirry tuotantoon
Todennus
Todennat pyynnöt tilisi API-päätepisteellä ja Bearer-tokenilla. API-krediittien oston jälkeen voit nähdä päätepisteen ja tokenin tilisi hallintapaneelissa. Pidä token salassa äläkä koskaan committoi sitä julkisiin repositorioihin.
API Päätepiste
Korvaa {your-api-domain} tilisi hallintapaneelissa näkyvällä API-päätepisteellä.
Otsakkeet
Koodiesimerkit
Aloita nopeasti koodiesimerkeillämme
#!/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"Pyyntöparametrit
Määritä API-pyyntösi näillä parametreilla
| Parametri | Tyyppi | Kuvaus |
|---|---|---|
| image | string | Base64-koodattu kuvatieto, joka URL-koodataan. Enintään 10 MB. Lyhin sivu vähintään 512 px ja pisin sivu enintään 8192 px. Tukee jpg/jpeg/png/bmp. Anna image tai url. |
| url | string | Täydellinen kuvan URL, enintään 1024 tavua. Koodatun kuvan on pysyttävä alle 10 MB:n. Lyhin sivu vähintään 512 px ja pisin sivu enintään 8192 px. Tukee jpg/jpeg/png/bmp. Anna image tai url ja poista hotlink-suojaus käytöstä. |
| return_heatmap | string | Määrittää palautetaanko väärennös-heatmap. Oletus: false. true palauttaa Base64-heatmapin, false ei palauta. |
| detect_proportion | string | Määrittää palautetaanko manipuloinnin luottamusarvo. Oletus: false. true palauttaa arvon, false ei palauta. |
| restrict_probability | string | Kynnysarvo väärennöskoordinaattien palauttamiseen. Alue: 0.1–1 yhdellä desimaalilla. Oletus: 0.8. tampered_location palautetaan vain, kun probability saavuttaa tai ylittää tämän kynnyksen. |
Vastausparametrit
API-vastauskenttien viite
| Parametri | Tyyppi | Kuvaus |
|---|---|---|
| detection_result | string | Manipulointitulos: "fake" tarkoittaa, että manipulointi havaittiin, ja "real" tarkoittaa, ettei manipulointia havaittu. |
| tampered_proportion | float | Manipuloinnin luottamusarvo, palautetaan kun detect_proportion = true. |
| heatmap | string | Manipuloitujen alueiden Base64-heatmap, palautetaan kun return_heatmap = true. |
| tampered_location | array | Taulukko epäilyttävien alueiden koordinaateista, palautetaan kun probability on suurempi tai yhtä suuri kuin restrict_probability. Jokainen alkio sisältää left, top, width, height ja probability. |
| left | uint32 | Epäilyttävän alueen vasemman yläkulman vaakasuuntainen koordinaatti. |
| top | uint32 | Epäilyttävän alueen vasemman yläkulman pystysuuntainen koordinaatti. |
| width | uint32 | Epäilyttävän alueen leveys. |
| height | uint32 | Epäilyttävän alueen korkeus. |
| probability | float | Tämän epäilyttävän alueen luottamusarvo. |
Virhekoodit
Viite API-vastauskoodeille
| Virhekoodi | Virheilmoitus |
|---|---|
| 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 näytetään upstream-palvelun raaka-arvoina, jotta ne vastaavat täsmälleen tuotantovastauksia.
API Hinnoittelusuunnitelmat
Edullisempi kuin kertaluonteiset krediittipaketit. Tilaukset ovat edelleen edullisin vaihtoehto toistuvaan käyttöön.
Kehittäjä
Paras arviointiin ja varhaiseen integraatioon
- Bearer token -todennus
- Väärennöstulos, luottamusarvo, heatmap ja alueen koordinaatit
- Rakennettu manipuloitujen asiakirjojen ja kuvien tarkistusprosesseihin
- Endpoint ja token saatavilla hallintapaneelissa oston jälkeen
Kasvu
Paras tuotantopilotteihin ja vakaaseen käyttöön
- Bearer token -todennus
- Väärennöstulos, luottamusarvo, heatmap ja alueen koordinaatit
- Rakennettu manipuloitujen asiakirjojen ja kuvien tarkistusprosesseihin
- Endpoint ja token saatavilla hallintapaneelissa oston jälkeen
Skaala
Paras erätyönkulkuihin ja usean projektin tiimeille
- Bearer token -todennus
- Väärennöstulos, luottamusarvo, heatmap ja alueen koordinaatit
- Rakennettu manipuloitujen asiakirjojen ja kuvien tarkistusprosesseihin
- Endpoint ja token saatavilla hallintapaneelissa oston jälkeen
Yritys
Paras pitkäaikaisiin tuotantokuormiin
- Bearer token -todennus
- Väärennöstulos, luottamusarvo, heatmap ja alueen koordinaatit
- Rakennettu manipuloitujen asiakirjojen ja kuvien tarkistusprosesseihin
- Endpoint ja token saatavilla hallintapaneelissa oston jälkeen
Miksi kehittäjät luottavat API:imme
Rakennettu tuotantotyömääriä varten, väärennösten havaitsemisen API:imme tasapainottaa laadun, suorituskyvyn ja kustannukset, jotta voit luottaa siihen todellisissa sovelluksissa.
Tuotantovalmis luotettavuus
Korkea saatavuus ja vakaa suorituskyky viritetty todelliseen liikenteeseen.
Optimoitu väärennösten havaitsemiseen
Mallit keskittyvät asiakirjoihin, sertifikaatteihin ja laskuihin manipulointihavainnolla johdonmukaisempia tuloksia varten.
Ennustettava, vain API-hinnoittelu
Omistetut API-suunnitelmat selkeillä luottokustannuksilla pitkäaikaisille integraatioille.
Tuki kun sitä tarvitset
Sähköpostituki auttaa sinua diagnosoimaan ongelmia ja parantamaan integraatiotasi ajan myötä.
1 API-krediitti = 1 API-pyyntö. API-hinnoittelu on alempi kuin kertaluonteisten krediittipakettien, kun taas tilaukset ovat edelleen taloudellisin vaihtoehto jatkuvaan käyttöön.