Developer Documentation

ProofAI API Documentation

Integrate AI detection and the Readability Rewriter into your platform using secure, developer-friendly REST APIs with clear specs and examples.

Get API Key Explore API Platform

1. Introduction

The ProofAI API allows developers to seamlessly integrate AI-powered features such as AI text detection, readability rewriting, and authenticity verification directly into their applications.

Developer Benefits: Automate content moderation, guarantee publish-ready human authentic text, protect academic integrity, and future-proof digital environments against AI spam.

2. Authentication

ProofAI authenticates API requests via API keys. You must pass your secure secret key and registered domain in the request headers. If you don't have one, generate it in your API Keys Dashboard.

Required Authorization Headers

x-api-keyYour secret API key (e.g., sk_live_...).
OriginThe domain matching your generated API key constraints.

Example cURL with Auth:

curl https://ai.proofai.in/api/v1/detect \
  -H class="code-string">"x-api-key: YOUR_API_KEY" \
  -H class="code-string">"Origin: YOUR_DOMAIN"

3. Base URL

All API endpoints utilize the strictly defined base address. Only HTTPS is supported.

Base Addresshttps://ai.proofai.in/api/v1

4. Error Handling

Our API uses conventional HTTP response codes to indicate the success or failure of an API request. Codes in the 2xx range indicate success, 4xx indicate errors (e.g. missing param), and 5xx indicate internal system errors.

HTTP Status	Explanation
200 OK	Request succeeded. Response payload included.
400 Bad Request	Invalid request parameters or payload format.
401 Unauthorized	Missing or invalid API key. Origin domain mismatch.
429 Rate Limit	Quota exceeded or too many requests. Slow down.
500 Server Error	Internal issue on our modeling servers.

Standard JSON Error Body:

{
  "error": {
    "message": "Invalid API key or Origin Domain mismatch.",
    "type": "authentication_error"
  }
}

POSThttps://ai.proofai.in/api/v1/detect

Detect AI Content

Analyze text content to determine the probability of it being AI-generated or written by a human.

Request Parameters

Parameter	Type	Description
content*	string	The text content to analyze. Minimum 50 words recommended.

Integration Examples

curl -X POST https://ai.proofai.in/api/v1/detect \
  -H class="code-string">"x-api-key: YOUR_API_KEY" \
  -H class="code-string">"Origin: YOUR_DOMAIN" \
  -H class="code-string">"Content-Type: application/x-www-form-urlencoded" \
  -d class="code-string">"content=The text you want to analyze goes here."

Success Response

200 OK

{
  "ai_probability": 85,
  "human_probability": 15,
  "final_probability": 85,
  "verdict": "Likely AI",
  "input_type": "text",
  "model_version": "v1.0",
  "segments": [
    {
      "text": "The text you want to analyze goes here.",
      "ai_prob": 85,
      "human_prob": 15,
      "color_label": "red",
      "is_data": true
    }
  ]
}

Error Response

400 Bad Request

{
  "error": "Invalid API Key or Domain Not Authorized"
}

POSThttps://ai.proofai.in/api/v1/regenerate

Readability Rewriter API

Transform AI-generated text into natural, human-like content while preserving its original meaning.

Request Parameters

Parameter	Type	Description
content*	string	The text you want to rewrite for clarity. Minimum 50 words recommended.

Integration Examples

curl -X POST https://ai.proofai.in/api/v1/regenerate \
  -H class="code-string">"x-api-key: YOUR_API_KEY" \
  -H class="code-string">"Origin: YOUR_DOMAIN" \
  -H class="code-string">"Content-Type: application/x-www-form-urlencoded" \
  -d class="code-string">"content=AI generated text here."

Success Response

200 OK

{
  "regenerated": true,
  "humanized_text": "Natural human version of your text.",
  "original_ai_prob": 98,
  "new_human_prob": 95,
  "input_type": "text",
  "model_version": "v1.0"
}

Error Response

400 Bad Request

{
  "error": "Text is too short for humanization."
}

Build Faster with ProofAI APIs

Start integrating detection and Readability Rewriter endpoints with secure keys and domain-based access control.

Get Your API Key Explore API Platform