KleboAI Developer API

The KleboAI API enables programmatic access to our AI image detection engine. Submit any image and receive a confidence score indicating whether the content is AI-generated or authentic.

The API is REST-based, returns JSON responses, and authenticates via Bearer tokens. It supports image upload via multipart form data.

Get started in four steps — generate an API key, authenticate, send an image, and receive a detection result.

1. Create an account at kleboai.com
2. Generate an API key from your Dashboard
3. Authenticate with your Bearer token
4. Send an image to the scan endpoint
5. Receive AI-generation confidence score

All API requests require a Bearer token in the Authorization header. Obtain your token via the /auth/login endpoint or by generating an API key in your Dashboard.

Authorization: Bearer <your-access-token>

Tokens expire after a set period. Use the /auth/refresh-token endpoint with a valid refresh token to obtain a new access token. If both tokens expire, you must authenticate again.

The following endpoints are available. All endpoints use the base URL configured in your environment.

Note: Exact backend endpoints may vary. The above are documented from the frontend integration code and may be updated as the API evolves.

The core endpoint analyzes an uploaded image and determines the likelihood it was generated by AI.

Send the image as a FormData field named image. The response includes the detection verdict, confidence score, and remaining credits.

A typical scan request sends a single image file. The response wraps the result in a standard success envelope.

POST /scan/image
Content-Type: multipart/form-data
Authorization: Bearer <token>

--boundary
Content-Disposition: form-data; name="image"; filename="photo.jpg"
Content-Type: image/jpeg

<binary image data>
--boundary--

{
  "success": true,
  "statusCode": 200,
  "message": "Image scanned successfully.",
  "data": {
    "status": "completed",
    "type": "image",
    "aiGenerated": true,
    "confidence": 0.87,
    "creditsRemaining": 42,
    "providerResponse": {
      "status": "success",
      "request": {
        "id": "req_abc123",
        "timestamp": 1693000000000,
        "operations": 1
      },
      "type": {
        "ai_generated": 87
      },
      "media": {
        "id": "media_xyz789",
        "uri": "https://..."
      }
    }
  }
}

{
  "success": false,
  "statusCode": 401,
  "message": "Unauthorized"
}

curl -X POST https://example.com/scan/image \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "image=@/path/to/image.jpg"

Replace YOUR_ACCESS_TOKEN with the token from your authentication flow and /path/to/image.jpg with the local path to your image file.

Use the native fetch API with FormData to upload and scan an image.

async function scanImage(file) {
  const formData = new FormData();
  formData.append("image", file);

  const response = await fetch("https://example.com/scan/image", {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    },
    body: formData,
  });

  const result = await response.json();
  console.log("AI Generated:", result.data.aiGenerated);
  console.log("Confidence:", result.data.confidence);
  console.log("Credits left:", result.data.creditsRemaining);

  return result;
}

Use the requests library to upload and scan an image via the API.

import requests

def scan_image(file_path, token):
    url = "https://example.com/scan/image"
    headers = {"Authorization": f"Bearer {token}"}

    with open(file_path, "rb") as f:
        files = {"image": f}
        response = requests.post(url, headers=headers, files=files)

    result = response.json()
    print(f"AI Generated: {result['data']['aiGenerated']}")
    print(f"Confidence:   {result['data']['confidence']}")
    print(f"Credits left: {result['data']['creditsRemaining']}")
    return result

The API uses standard HTTP status codes. Responses include a message field describing the error.

Error codes are based on the frontend error handling patterns and standard REST conventions. Exact backend codes may differ.

KleboAI uses a credit-based system. Each image scan deducts one credit from your balance. Credits are purchased via packages available in your Dashboard.

Your remaining credits are returned with each scan response in the creditsRemaining field. You can view your credit balance and transaction history via the /wallet/summary and /wallet/transactions endpoints.

Rate limits protect the API from abuse and ensure fair usage. When exceeded, the API returns a 429 Too Many Requests status.

Implement exponential backoff in your client to handle rate limits gracefully. The Retry-After header (if present) indicates how many seconds to wait before retrying.

{
  "success": false,
  "statusCode": 429,
  "message": "Too many requests. Please try again later."
}

Exact rate limits are determined by your plan and account tier. Contact support for enterprise limit details.

API keys allow your applications to authenticate with the KleboAI API. View, generate, and manage keys from your Dashboard.

The /api-keys endpoint returns your current API key along with createdAt and lastUsedAt timestamps. Use the regenerate endpoint to create a new key (the old key is invalidated).

{
  "success": true,
  "data": {
    "apiKey": "kb_live_abc123def456...",
    "createdAt": "2024-01-15T10:30:00Z",
    "lastUsedAt": "2024-08-20T14:22:00Z"
  }
}

For API integration questions, enterprise partnerships, or technical support, reach out through the contact form or email.