AIHumanizer API Documentation
Empower your applications with advanced AI humanization capabilities. Seamlessly convert AI-generated content into natural, engaging, and human-like text with our powerful, secure, and easy-to-integrate REST API.
Introduction
Welcome to the AIHumanizer API documentation! This guide provides detailed information on how to integrate and use our API to transform your AI-generated text into high-quality, human-readable content. Our cutting-edge algorithms ensure that the output maintains the original meaning while significantly improving readability, flow, and style, making it indistinguishable from human-written text.
Whether you're building content creation tools, academic platforms, or simply need to refine AI drafts, AIHumanizer offers a robust solution. This documentation will walk you through everything from authentication to specific endpoint usage, error handling, and best practices.
Getting Started
- Sign Up & Get Your API Key: Register on our Developer Portal to obtain your unique API key.
- Login: Succesfully Login then click on ai to human Get API Key.
- Explore Endpoints: Familiarize yourself with the available API endpoints and their functionalities.
- Implement Authentication: Integrate your API key into your application's requests.
- Make Your First Request: Use the provided code examples to send your first API call.
- Handle Responses: Learn how to parse API responses and implement error handling.
Authentication
All requests to the AIHumanizer API must be authenticated using an API key. Your API key identifies you as a legitimate user and ensures secure access to our services. Failure to include a valid API key will result in a 401 Unauthorized response.
API Key Header
Include your secret API key in the Authorization header of every request, using the Bearer scheme.
Authorization: Bearer YOUR_API_KEY_HERE
Example:
curl -X GET \
'https://isolatedstudy.in/api/token_infos' \
-H 'Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
Keep your API key confidential and never expose it in client-side code or public repositories.
Endpoints
Our API is built on REST principles, allowing for straightforward integration using standard HTTP methods. All API requests should be made to the base URL: https://isolatedstudy.in
POST /api/humanize
Description: Converts AI-generated content into a humanized version, improving natural language flow, readability, and stylistic elements. This is the primary endpoint for content transformation.
Request Parameters (Body)
| Parameter | Type | Required | Description |
|---|---|---|---|
aiText |
String | Yes | The AI-generated content (plain text) that you want to humanize. Maximum length: 10,000 characters. |
Example Request Body
{
"aiText": "The word army evokes images of discipline, ..."
}
Successful Response (HTTP 200 OK)
| Parameter | Type | Description |
|---|---|---|
convertedText |
String | The successfully humanized version of the input text. |
tokens_used |
Integer | The number of tokens consumed for this request. |
tokens_remaining |
Integer | The number of tokens remaining in your daily or subscription limit. |
Example Successful Response
{
"convertedText": "Humanized version of your text...",
"tokens_used": 83,
"tokens_remaining": 917
}
Code Examples
import requests
url = "https://isolatedstudy.in/api/humanize"
payload = {"aiText": "The word army evokes images of discipline..."}
headers = {
"Authorization": "Bearer yourapikey",
"Content-Type": "application/json"
}
response = requests.request("POST", url, json=payload, headers=headers)
print(response.text)
GET /api/token_infos
Description: Retrieves information about your API token, including daily usage limits, remaining tokens, and expiration date. (Note: The provided image does not show a response for this endpoint, so this structure is based on common API practices).
Successful Response (HTTP 200 OK)
| Parameter | Type | Description |
|---|---|---|
tokens_remaining |
Integer | The total number of tokens left in your subscription. This value decreases with usage. |
expiration_date |
String (ISO 8601) | The expiration date of your current API subscription. Format: YYYY-MM-DD. |
Example Successful Response
{
"tokens_remaining": 58375025,
"expiration_date": "2026-12-31",
"success": true
}
Code Examples
import requests
import json
api_key = "yourapikey"
api_url = "https://isolatedstudy.in/api/token_infos"
headers = {
"Authorization": f"Bearer {api_key}"
}
try:
response = requests.get(api_url, headers=headers)
response.raise_for_status() # Raise an exception for HTTP errors (4xx or 5xx)
print(json.dumps(response.json(), indent=2))
except requests.exceptions.HTTPError as err:
print(f"HTTP error occurred: {err}")
print(f"Response content: {response.text}")
except Exception as err:
print(f"An error occurred: {err}")
Rate Limits
To ensure fair usage and optimal performance for all users, our API enforces rate limits based on your subscription plan. These limits are typically measured by characters processed per day and requests per minute.
Exceeding your allocated rate limits will result in a 429 Too Many Requests HTTP status code. We recommend implementing retry logic with exponential backoff in your application to gracefully handle rate limit excursions.
Common Limits:
- Daily Token/Character Limit: Varies by plan (e.g., 1,000,000 characters/day for Standard Plan).
- Requests Per Minute (RPM): Typically 60 RPM for most endpoints.
- Burst Limit: Short bursts of up to 100 requests in 5 seconds may be allowed before throttling.
You can monitor your daily token/character usage and remaining limits using the GET /api/token_infos endpoint.
Error Handling
The AIHumanizer API uses standard HTTP status codes to indicate the success or failure of an API request. In case of an error, the response body will contain a JSON object with more details about the error, including an error code and a descriptive message.
Common HTTP Status Codes & Error Responses
| Status Code | Description | Example Response Body |
|---|---|---|
200 OK |
Request successful. | { "convertedText": "...", "tokens_used": ..., "tokens_remaining": ... } |
400 Bad Request |
The request was malformed or missing required parameters. | { "error": { "code": "invalid_parameter", "message": "The 'aiText' field is required." } } |
401 Unauthorized |
Authentication failed or no API key was provided. | { "error": "Invalid API key" } |
403 Forbidden |
Access to the requested resource is forbidden (e.g., insufficient permissions, expired plan). | { "error": "Subscription expired" } |
404 Not Found |
The requested endpoint does not exist. | { "error": { "code": "not_found", "message": "Endpoint not found." } } |
429 Too Many Requests |
You have exceeded your rate limits. | { "error": "Insufficient tokens" } |
500 Internal Server Error |
An unexpected error occurred on the server. Please report this if it persists. | { "error": { "code": "server_error", "message": "An internal server error occurred." } } |
When handling errors, it's best practice to check the HTTP status code first, then parse the JSON response body for specific error codes and messages to provide user-friendly feedback or log details for debugging.
SDKs & Libraries(Not Available Currently)
To simplify integration, we provide official and community-contributed Software Development Kits (SDKs) and client libraries for popular programming languages. These SDKs abstract away the complexities of HTTP requests, authentication, and JSON parsing, allowing you to focus on building your application.
Official SDKs:
- Python:
aihumanizer-python(PyPI) -pip install aihumanizer-python - Node.js:
@aihumanizer/sdk(npm) -npm install @aihumanizer/sdk
Refer to the respective SDK documentation for installation instructions and usage examples. We also welcome community contributions to expand our SDK offerings.
Version History
We continuously improve our API, introducing new features, optimizing performance, and resolving issues. Here's a brief overview of the major API versions.
Version 1.0 (Current) - May 27, 2025
- Initial stable release of the AI Humanization API.
- Introduced
POST /api/humanizeendpoint for text conversion. - Implemented
GET /api/token_infosfor usage monitoring. - Standardized authentication via
Authorization: Bearerheader. - Introduced comprehensive error codes and rate limiting.
Upcoming Versions:
- V1.1 (Q3 2025): Planned additions include support for custom style guides, multi-language humanization, and improved sentiment control.
Stay subscribed to our Developer Blog for updates on new features and breaking changes.
Support
If you encounter any issues, have questions, or require assistance with integrating the AIHumanizer API, please don't hesitate to reach out to our support team.
- Email Support: isolatedinfo@Isolatedstudy.com
- Live Chat: Available on our main website during business hours (9 AM - 5 PM IST, Monday - Friday).
- FAQ & Knowledge Base: Visit our FAQ page for answers to common questions and troubleshooting guides.
- Bug Reports: Please use our issue tracker on GitHub for reporting bugs.
We aim to respond to all support inquiries within 24 business hours.