AI-afbeeldingsdetectie-API

1. Vraag een vooraf ondertekende upload-URL aan

Vraag eerst een vooraf ondertekende URL aan bij de API. Met deze URL upload u uw afbeeldingsbestand veilig naar de opslagserver.

GET https://detect-image.truthscan.com/get-presigned-url?file_name=example.jpg

Voorbeeldverzoek

curl -X GET 'https://detect-image.truthscan.com/get-presigned-url?file_name=example.jpg' \
--header 'apikey: YOUR API KEY GOES HERE'

Voorbeeldantwoord

{
  "status": "success",
  "presigned_url": "https://image-presigned-upload.ai-assets-cdn.com?file_name=581d47c7-3ef4-42af-88d9-6dab6bf69389_20250611-121955_example.jpg?...",
  "file_path": "uploads/example.jpg"
}

2. Upload de afbeelding

Gebruik de opgegeven 'presigned_url' om uw afbeelding via een PUT-verzoek te uploaden. Zorg dat het juiste content type is ingesteld volgens uw afbeeldingsformaat.

Voorbeeldverzoek

curl -X PUT 'https://image-presigned-upload.ai-assets-cdn.com?file_name=581d47c7-3ef4-42af-88d9-6dab6bf69389_20250611-121955_example.jpg?...' \
  --header 'Content-Type: image/<FILE_FORMAT - jpeg, jpg, png, webp, heic, heif, avif, bmp, tiff, tif>' \
  --header 'x-amz-acl: private' \
  --data-binary '@example.jpg' # Attachment

Zorg dat het bestandsformaat tijdens het uploaden gelijk blijft. Een geslaagde upload geeft statuscode 200 terug.

3. Dien afbeelding in voor AI-detectie

Na het uploaden dient u de afbeelding in voor AI-detectie door te verwijzen naar 'file_path' uit de vorige stap.

POST https://detect-image.truthscan.com/detect

Voorbeeldverzoek

curl -X 'POST' \
  'https://detect-image.truthscan.com/detect' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "key": "YOUR-API-KEY-GOES-HERE",
  "url": "https://ai-image-detector-prod.nyc3.digitaloceanspaces.com/<FILE_PATH>",
  "generate_preview": false,
  "generate_analysis_details": true
}'

'FILE_PATH' verwijst naar het pad uit het antwoord in de eerste stap, 'Vraag een vooraf ondertekende upload-URL aan'.

Voorbeeldantwoord

{
    "id": "77565038-9e3d-4e6a-8c80-e20785be5ee9",
    "status": "pending"
}

Het antwoord bevat een unieke afbeeldings-ID om de detectiestatus te volgen.

1. Eerste resultaat klaar (analyse nog bezig)

Bij indienen met 'generate_analysis_details': true en eerste query met status 'done' zijn de kernresultaten (result, final_result, confidence) klaar. analysis_results_status kan nog 'pending' zijn — de diepe AI-analyse loopt dan nog.

{
    "id": "00fee5ff-a55b-42fb-b7c7-d14f05ae0769",
    "status": "done",
    "result": 90.2371538185235,
    "result_details": {
        "is_valid": true,
        "detection_step": 3,
        "final_result": "AI Generated",
        "confidence": 90.2371538185235,
        "analysis_results_status": "pending",
        "analysis_results": null
    }
}

2. Blijf pollen voor analyseresultaten

Roep /query opnieuw aan met dezelfde image ID. Controleer analysis_results_status. Als die van 'pending' naar 'done' gaat, wordt analysis_results gevuld.

curl -X 'POST' \
  'https://detect-image.truthscan.com/query' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "id": "00fee5ff-a55b-42fb-b7c7-d14f05ae0769"
}'

3. Analyse volledig — volledig antwoord

Als analysis_results_status 'done' is, bevat analysis_results de volledige diepe analyse met overeenstemming, betrouwbaarheid, indicatoren, uitleg, visuele patronen en aanbevelingen.

{
    "id": "00fee5ff-a55b-42fb-b7c7-d14f05ae0769",
    "status": "done",
    "result": 90.2371538185235,
    "result_details": {
        "is_valid": true,
        "detection_step": 3,
        "final_result": "AI Generated",
        "confidence": 90.2371538185235,
        "heatmap_status": "ready",
        "heatmap_url": "https://ai-image-detector-prod.nyc3.digitaloceanspaces.com/uploads/....",
        "analysis_results_status": "done",
        "analysis_results": {
            "agreement": "strong",
            "confidence": 92,
            "keyIndicators": [
                "Unnaturally smooth skin texture",
                "Consistent lighting anomalies"
            ],
            "detailedReasoning": "The image shows clear signs of AI generation with unnaturally smooth textures and consistent lighting patterns not typical of real photography.",
            "visualPatterns": [
                "Uniform noise pattern typical of diffusion models"
            ],
            "recommendations": [
                "Cross-reference with original source if available",
                "Check for metadata inconsistencies",
                "Compare with known AI generation patterns"
            ]
        }
    },
    "preview_url": "https://ai-image-detector-prod.nyc3.digitaloceanspaces.com/previews/..."
}

Wanneer analyse niet beschikbaar is

Als analysis_results_status 'skipped', null of ontbreekt, wordt geen diepe analyse gemaakt. Dat gebeurt als 'generate_analysis_details' niet 'true' was in /detect, of bij bepaalde afbeeldingen/scenario's. Beschouw de eerste detectieresultaten dan als definitief.

{
    "status": "done",
    "result": 12.5,
    "result_details": {
        "analysis_results_status": "skipped",
        "analysis_results": null
    }
}

"User verification failed" (403)

Oorzaak: Ongeldige of verlopen API-sleutel

Oplossing:

1. Controleer of uw API-sleutel klopt
2. Controleer of uw API-sleutel actief is in uw account
3. Genereer zo nodig een nieuwe API-sleutel

"Not enough credits" (403)

Oorzaak: Onvoldoende credits voor beeldverwerking

Oplossing:

1. Controleer uw resterende credits via /check-user-credits
2. Koop indien nodig extra credits
3. Optimaliseer de afbeeldingsgrootte vóór upload om minder credits te verbruiken

"Unsupported file format" (400)

Oorzaak: Niet-ondersteund of ongeldig afbeeldingsformaat

Oplossing:

1. Controleer of het formaat wordt ondersteund (JPG, JPEG, PNG, WebP, JFIF, HEIC, HEIF, AVIF, BMP, TIFF, TIF)
2. Controleer of het bestand niet beschadigd is
3. Controleer de Content-Type-header bij uploaden

"File too large" (400)

Oorzaak: Bestandsgrootte overschrijdt de limiet van 10 MB

Oplossing:

1. Verklein of comprimeer de afbeelding tot onder 10 MB
2. Controleer de bestandsgrootte vóór upload
3. Gebruik waar mogelijk efficiëntere formaten zoals WebP

"Request timeout" (WebSocket)

Oorzaak: Beeldverwerking duurde te lang

Oplossing:

1. Probeer een kleiner of minder complex beeld
2. Controleer of de service hoge belasting heeft
3. Probeer het verzoek opnieuw

Documentstatus "failed"

Oorzaak: Verwerking om diverse redenen mislukt

Oplossing:

1. Controleer of de afbeelding aan de minimumvereisten voldoet (1 KB – 10 MB)
2. Controleer of het formaat wordt ondersteund
3. Controleer of de upload succesvol was vóór indienen voor detectie
4. Neem contact op met support als het probleem aanhoudt

"Image upload failed" (403/400)

Oorzaak: Ongeldige of verlopen vooraf ondertekende URL, of problemen met de opslagserver

Oplossing:

1. Gebruik de vooraf ondertekende URL direct na ontvangst (kan verlopen)
2. Controleer of de Content-Type-header klopt voor het afbeeldingsformaat
3. Verwijder spaties uit de bestandsnaam vóór upload
4. Genereer een nieuwe vooraf ondertekende URL als de huidige is verlopen

"Invalid pre-signed URL" (400)

Oorzaak: Bestandsnaam met spaties of verlopen/beschadigde vooraf ondertekende URL

Oplossing:

1. Verwijder alle spaties uit de bestandsnaam vóór het aanvragen van de URL
2. Gebruik alleen alfanumerieke tekens, koppeltekens en underscores in de bestandsnaam
3. Genereer zo nodig een nieuwe vooraf ondertekende URL