Skip to main content
POST
/
v1
/
humanize
Humanize text
curl --request POST \
  --url https://api.gpthuman.ai/v1/humanize \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "text": "<string>",
  "tone": "Standard",
  "mode": "Professional"
}
'
{
  "id": "<string>",
  "language": "<string>",
  "similarity": 123,
  "readability": 123,
  "humanScore": 123,
  "status": 123,
  "output": "<string>",
  "outputWordCount": 123,
  "outputCharCount": 123,
  "creditUsage": 123,
  "creditBalance": 123,
  "tone": "<string>",
  "mode": "<string>",
  "wordCount": 123,
  "charCount": 123,
  "timestamp": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
text
string
required

The text to humanize. Must be at least 300 characters and must not exceed 2,000 words.

Minimum string length: 300
​
tone
enum<string>

Optional tone for the rewritten text. Defaults to College when omitted.

Available options:
Standard,
HighSchool,
College,
PhD
​
mode
enum<string>

Optional rewrite mode. Defaults to Balanced when omitted.

Available options:
Professional,
Balanced,
Enhanced

Response

Successful humanization response.

​
id
string
required

Unique identifier for the request.

​
language
string
required

Detected language of the processed text.

​
similarity
number
required

Similarity score returned by the humanization provider.

​
readability
number
required

Readability score returned by the humanization provider.

​
humanScore
number | null
required

AI detector human score for the rewritten output. Can be null when language is not supported by AI detector.

​
status
integer
required

HTTP status code returned by the endpoint.

​
output
string
required

Human-sounding version of the input text.

​
outputWordCount
integer
required

Word count of the rewritten output.

​
outputCharCount
integer
required

Character count of the rewritten output. Note: field name currently contains a typo in the live API.

​
creditUsage
integer
required

Number of credits consumed by this request.

​
creditBalance
integer
required

Remaining credit balance after the request.

​
tone
string
required

Tone applied to the request after default resolution.

​
mode
string
required

Mode applied to the request after default resolution.

​
wordCount
integer
required

Word count of the input text.

​
charCount
integer
required

Character count of the input text.

​
timestamp
string<date-time>
required

ISO 8601 timestamp for the request.