API Documentation

Integrate our AI humanization service into your applications

API Keys

Manage your API keys for authentication

No API keys found

Authentication

All API requests must be authenticated using your API key. Include your API key in the request header.

Header Format

x-api-key: your_api_key_here

Security Best Practices

• Never expose your API key in client-side code
• Store API keys securely using environment variables
• Rotate your API keys regularly
• Monitor API key usage for suspicious activity

Getting Started

Welcome to our AI Humanization API! This guide will help you get started with integrating our service into your applications.

Quick Start

Create an API key, make your first request, and start humanizing AI-generated content in minutes.

Step 1: Create an API Key

Click the "Create API Key" button to generate your authentication credentials. Keep your API key secure and never share it publicly.

Step 2: Make Your First Request

Use your API key to authenticate requests to our endpoints. Here's a simple example:

cURL Example

curl -X POST https://restructai.enlightir.com/api/v1/humanize \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key_here" \
  -d '{
    "content": "Your AI-generated content here",
    "model": "standard"
  }'

Step 3: Handle the Response

Our API returns structured JSON responses with your humanized content and metadata.

Available Models

Choose from our range of humanization models, each optimized for different use cases.

Rate Limits

API requests are subject to rate limiting to ensure fair usage and system stability.

Basic Tier

• 100 requests per hour
• 1,000 requests per day
• 10,000 characters per request

Pro Tier

• 1,000 requests per hour
• 10,000 requests per day
• 50,000 characters per request

Rate Limit Headers

Response Headers

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1642694400
X-RateLimit-Retry-After: 3600

Rate Limit Exceeded

When you exceed rate limits, you'll receive a 429 status code. Implement exponential backoff in your retry logic.

Submitting a Humanization Task

Submit your AI-generated content for humanization using our processing endpoint.

Endpoint

POST Request

POST https://your-domain.com/api/v1/humanize

Request Body

JSON Payload

{
  "content": "This is AI-generated content that needs to be humanized to sound more natural and authentic.",
  "model": "proto-v1",
  "mode": "humanise",
  "callback_url": "https://your-app.com/webhook/humanize"
}

Immediate Response

Success Response

{
  "task_id": "task_1234567890abcdef",
  "status": "processing",
  "progress": 65,
  "created_at": "2024-01-20T10:30:00Z",
  "started_at": "2024-01-20T10:30:02Z"
}

Processing Response

processing Response

{
  "task_id": "task_1234567890abcdef",
  "status": "pending",
  "created_at": "2024-01-20T10:30:00Z",
  "estimated_completion": "2024-01-20T10:30:15Z"
}

Complete Response

{
  "task_id": "task_1234567890abcdef",
  "status": "completed",
  "result": {
    "humanized_content": "This content has been transformed to sound more natural and authentic, with improved flow and human-like characteristics.",
    "original_length": 128,
    "humanized_length": 142,
    "confidence_score": 0.94
  },
  "created_at": "2024-01-20T10:30:00Z",
  "completed_at": "2024-01-20T10:30:12Z",
  "processing_time": 12.4
}

API Reference

Language:

POST/api/v1/humanize

Submit content for AI humanization processing.

Request

JavaScript Example

const response = await fetch('https://your-domain.com/api/v1/humanize', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'your_api_key_here'
  },
  body: JSON.stringify({
    content: 'Your AI-generated content here',
    model: 'standard'
  })
});

const data = await response.json();
console.log(data.task_id);

Parameters

Parameter	Type	Required	Description
content	string	Yes	The AI-generated content to humanize
model	string	No	Model to use (default: "standard")
mode	string	No	Processing mode: "fast" or "quality" (default: "fast")
callback_url	string	No	URL to receive webhook notifications

GET/api/v1/task/{task_id}

Retrieve the status and results of a humanization task.

Request

JavaScript Example

const response = await fetch('https://your-domain.com/api/v1/task/task_1234567890abcdef', {
  method: 'GET',
  headers: {
    'x-api-key': 'your_api_key_here'
  }
});

const data = await response.json();
console.log(data.status);

Path Parameters

Parameter	Type	Description
task_id	string	Unique identifier for the task

GET/api/v1/tasks

List all your humanization tasks with pagination.

Request

JavaScript Example

const response = await fetch('https://your-domain.com/api/v1/tasks?page=1&limit=20&status=completed', {
  method: 'GET',
  headers: {
    'x-api-key': 'your_api_key_here'
  }
});

const data = await response.json();
console.log(data.tasks);

Query Parameters

Parameter	Type	Default	Description
page	integer	1	Page number for pagination
limit	integer	20	Number of tasks per page (max: 100)
status	string	all	Filter by status: "pending", "processing", "completed", "failed"