curl --request POST \
  --url https://api.copyleaks.com/v1/ai-image-detector/my-scan-123/check \
  --header 'Authorization: Bearer YOUR_LOGIN_TOKEN' \
  --form 'image=@/path/to/test-image.png' \
  --form 'filename=test-image.png' \
  --form 'sandbox=true' \
  --form 'model=ai-image-1-ultra' \
  --form 'maskType=heatmap' \
  --form 'objectDetection=[{"object":"face"},{"object":"hand"}]'

import base64
from copyleaks.copyleaks import Copyleaks
from copyleaks.clients.image_detection_client import ImageDetectionClient
from copyleaks.models.ai_image_detection import (
    CopyleaksAiImageDetectionRequestModel,
    CopyleaksAiImageDetectionModels,
)

auth_token = Copyleaks.login("[email protected]", "YOUR_API_KEY")

with open("test-image.png", "rb") as f:
    b64 = base64.b64encode(f.read()).decode("utf-8")

payload = CopyleaksAiImageDetectionRequestModel(
    base64=b64,
    filename="test-image.png",
    model=CopyleaksAiImageDetectionModels.AI_IMAGE_1_ULTRA,
    sandbox=True,
)

client = ImageDetectionClient()
response = client.submit(auth_token, "my-scan-123", payload)
print(response)

const imageFile = document.getElementById('fileInput').files[0];
const formData = new FormData();

formData.append('image', imageFile);
formData.append('filename', imageFile.name);
formData.append('sandbox', 'true');
formData.append('model', 'ai-image-1-ultra');
formData.append('maskType', 'heatmap');
// Optional: objects to locate, sent as a JSON-encoded string in one form field
formData.append('objectDetection', JSON.stringify([{ object: 'face' }, { object: 'hand' }]));

const response = await fetch(
  'https://api.copyleaks.com/v1/ai-image-detector/my-scan-123/check',
  {
    method: 'POST',
    headers: { 'Authorization': 'Bearer YOUR_LOGIN_TOKEN' },
    body: formData,
  }
);
const result = await response.json();

{
  "model": "ai-image-1-ultra",
  "result": {
    "starts": [0, 512, 1536, 2560],
    "lengths": [256, 512, 768, 1024]
  },
  "summary": { "human": 0.3, "ai": 0.7 },
  "isAiDetected": true,
  "imageInfo": {
    "shape": { "height": 1024, "width": 768 },
    "metadata": {
      "issuedTime": "2025-07-23T12:44:05",
      "issuedBy": "OpenAI",
      "appOrDeviceUsed": "OpenAI-API",
      "contentSummary": "Created using generative AI"
    }
  },
  "detectedObjects": [
    {
      "object": "face",
      "mask": { "starts": [1024, 3072], "lengths": [512, 256] }
    },
    {
      "object": "hand",
      "mask": { "starts": [8192], "lengths": [128] }
    }
  ],
  "scannedDocument": {
    "scanId": "my-scan-123",
    "actualCredits": 1,
    "expectedCredits": 1,
    "creationTime": "2023-01-10T10:07:58.9459512Z"
  }
}