Analyze image files

Upload one or more images and receive a verdict, confidence, and (on detailed plans) generator attribution and a deep-analysis breakdown for each image. Up to 10 images per request, max 50 MB each; formats `jpg`, `jpeg`, `png`, `webp`, `heic`, `heif`, `tiff`.

Authorization

BearerAuth

AuthorizationBearer <token>

Send your secret API token as a bearer token in the Authorization header: Authorization: Bearer <token>. Keep it server-side and never expose it in client code.

In: header

Request Body

multipart/form-data

TypeScript Definitions

Use the request body type in TypeScript.

imageFiles*array<>

One or more image files to analyze.

input.ExternalId?string

Optional caller-provided ID to correlate this analysis with your own systems.

sourceUrl?string

Optional source URL of the image, recorded for your own auditing.

Response Body

`application/json`

cURL

curl -X POST "https://example.com/api/app/image-forensics/process" \  -F imageFiles="[    \"string\"  ]"

import requestsurl = "https://example.com/api/app/image-forensics/process"body = {  "imageFiles": [    "string"  ]}response = requests.request("POST", url, data = body, headers = {  "Content-Type": "multipart/form-data"})print(response.text)

package mainimport (  "fmt"  "net/http"  "io/ioutil"  "mime/multipart"  "bytes")func main() {  url := "https://example.com/api/app/image-forensics/process"  body := new(bytes.Buffer)  mp := multipart.NewWriter(payload)  mp.WriteField("imageFiles", `[    "string"  ]`)  req, _ := http.NewRequest("POST", url, body)  req.Header.Add("Content-Type", "multipart/form-data")  res, _ := http.DefaultClient.Do(req)  defer res.Body.Close()  body, _ := ioutil.ReadAll(res.Body)  fmt.Println(res)  fmt.Println(string(body))}

import java.net.URI;import java.net.http.HttpClient;import java.net.http.HttpRequest;import java.net.http.HttpResponse;import java.net.http.HttpResponse.BodyHandlers;import java.time.Duration;import java.net.http.HttpRequest.BodyPublishers;var body = BodyPublishers.ofByteArray(new byte[] { ... });HttpClient client = HttpClient.newBuilder()  .connectTimeout(Duration.ofSeconds(10))  .build();HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()  .uri(URI.create("https://example.com/api/app/image-forensics/process"))  .header("Content-Type", "multipart/form-data")  .POST(body)  .build();try {  HttpResponse<String> response = client.send(requestBuilder.build(), BodyHandlers.ofString());  System.out.println("Status code: " + response.statusCode());  System.out.println("Response body: " + response.body());} catch (Exception e) {  e.printStackTrace();}

{
  "images": [
    {
      "id": "f1d2e3c4-5678-90ab-cdef-1234567890ab",
      "fileName": "suspect.jpg",
      "verdict": "ai_generated",
      "confidence": 0.972,
      "isManipulated": true,
      "creditsUsed": 1,
      "processingTimeMs": 1840,
      "errorMessage": null,
      "createdAt": "2026-06-07T12:34:56Z",
      "deepfakeScore": 0.12,
      "generators": {
        "midjourney": 0.95,
        "flux": 0.03
      },
      "deepAnalysis": {
        "agreement": "strong",
        "keyIndicators": [
          "Uniform texture across skin regions",
          "Lighting direction is inconsistent with shadows"
        ],
        "detailedReasoning": "The image shows rendering characteristics typical of AI generation, including uniform micro texture and inconsistent lighting.",
        "visualPatterns": [
          "Overly smooth gradients in the background"
        ],
        "recommendations": [
          "Request the original file from the source"
        ],
        "metadataFindings": [
          {
            "kind": "editingSoftware",
            "value": "Adobe Photoshop 24.0",
            "significance": "warning"
          },
          {
            "kind": "createdDate",
            "value": "2026:06:01 10:00:00",
            "significance": "info"
          },
          {
            "kind": "gpsPresent",
            "significance": "notable"
          }
        ]
      }
    }
  ],
  "totalCreditsUsed": 1,
  "totalProcessingTimeMs": 1840,
  "isSuccessful": true,
  "errorMessage": null,
  "hasDetailedReport": true
}

File too large

{
  "error": {
    "code": "IMAGE_FORENSICS:FILE_TOO_LARGE",
    "message": "File photo.jpg exceeds the maximum size of 50 MB."
  }
}

Unsupported format

{
  "error": {
    "code": "IMAGE_FORENSICS:UNSUPPORTED_FORMAT",
    "message": "Unsupported file format. Allowed — jpg, jpeg, png, webp, heic, heif, tiff."
  }
}

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API token."
  }
}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

`application/json`

`application/json`

`application/json`