API Documentation

AI Humanization API

Transform AI-generated text to sound more natural and human-like using advanced algorithms. This endpoint returns the humanized text along with comparative AI detection scores.

Token Usage

This endpoint consumes tokens from your token balance. Note that humanization previously used words, but now uses tokens.

Learn more about billing

Endpoint Details

Endpoint

POST /api/humanization

Headers

Content-Type: application/json X-API-Key: your_api_key_here

Request Body

{ "text": "Your AI-generated text to humanize..." }
ParameterTypeRequiredDescription
textstringYesThe AI-generated text to be humanized.

Success Response (200 OK)

{ "originalText": "The original AI-generated text...", "humanizedText": "The resulting humanized version of the text...", "wordCount": 120, // Example word count "originalResult": { "score": 0.85, "sentences": [ { "length": 45, "score": 0.92, "text": "This sentence was likely written by AI." } // ... more sentences ], "readability_score": 65 }, "humanizedResult": { "score": 0.35, "sentences": [ { "length": 45, "score": 0.42, "text": "This sentence now appears more human-like." } // ... more sentences ], "readability_score": 72 } // Note: The actual response might include token usage if implemented server-side }

Field Descriptions

Field PathTypeDescription
originalTextstringThe original input text.
humanizedTextstringThe resulting humanized text.
wordCountnumberWord count of the original text.
originalResultobjectAI detection analysis of the original text (see Detection API docs).
humanizedResultobjectAI detection analysis of the humanized text (see Detection API docs).

Error Responses

Example error for invalid input:

{ "error": "Invalid request body" // Example, actual errors may vary }

Refer to the Error Handling section for details on other potential errors (e.g., 401, 403, 429, 500).

Code Examples

Use the following examples to integrate the AI Humanization API.

curl -X POST https://your-api-domain.com/api/humanization \ -H "Content-Type: application/json" \ -H "X-API-Key: your_api_key_here" \ -d '{ "text": "Text to humanize..." }'

Model Usage

The humanization service defaults to using Anthropic's Claude model. Currently, specifying other models via the API is not supported but may be added in the future.