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 billingEndpoint 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..."
}
Parameter | Type | Required | Description |
---|---|---|---|
text | string | Yes | The 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 Path | Type | Description |
---|---|---|
originalText | string | The original input text. |
humanizedText | string | The resulting humanized text. |
wordCount | number | Word count of the original text. |
originalResult | object | AI detection analysis of the original text (see Detection API docs). |
humanizedResult | object | AI 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.