Sign in

v1

latestOpenAPI 3.0.1MIT2026-07-2661255.8 KB

Runs an advanced forensic analysis on a public image URL. The API authenticates the caller with a bearer token, checks the user's credit balance, analyzes the image, charges 500 credits after a successful analysis, and returns a structured forensic report.

post/v2/advanced-image-detection

Request body

image_urlstring required

Public HTTP or HTTPS URL of the image to analyze. The API rejects empty values, non-string values, URLs without a hostname, URLs with embedded credentials, localhost, .localhost, and direct private or reserved IP addresses.

Example request

{
  "image_url": "https://example.com/image.png"
}

Response

Advanced Image Detection response

statusinteger

Internal analysis status from the image analysis pipeline. The external HTTP status for a successful API request is 200 OK.

costinteger

Number of credits charged for this API request. Current value is 500.

languagestring

Language used for the generated analysis text.

titlestring

Short generated title describing the analyzed image.

tagsstring[]

Tags extracted or inferred from the image metadata and analysis pipeline.

tool_usedstring[]

List of internal forensic tool IDs used during the analysis. Possible values include classify_image, extract_metadata, ela_image, residual_noise_maps, edge_anomaly_heat_map, and cfa_pattern_analysis.

label'AI-Generated' | 'Human'

Final classification label for the image.

confidence'High' | 'Moderate' | 'Low'

Confidence level for the final classification.

authenticity'Authentic' | 'Manipulated'

Final authenticity assessment.

conclusionstring

Short final conclusion summarizing the forensic result.

analysisstring

Complete human-readable forensic analysis, including a summary of the tools used and their findings.

balanceinteger

User's remaining credit balance after the successful request is charged.

Example response

{
  "status": 200,
  "cost": 500,
  "language": "en",
  "title": "Portrait of a Person",
  "tags": [
    "portrait",
    "face"
  ],
  "tool_used": [
    "classify_image",
    "extract_metadata",
    "ela_image"
  ],
  "label": "AI-Generated",
  "confidence": "High",
  "authenticity": "Manipulated",
  "conclusion": "The image shows strong indicators of AI generation.",
  "tools_used_analysis": [
    {
      "id": "extract_metadata",
      "analysis": "The metadata is stripped of EXIF and C2PA information."
    }
  ],
  "balance": 9500
}
All 6 operations