Last updated

Humanize AI Docs (Beta)

The Humanize AI API enables you to submit and process text through humanization tasks. This API ensures validation, logging, and rate-limiting to handle requests securely and efficiently.

Currently, the endpoint is an equivalent of "ultra run" on the website.

Important: each request is charged, regardless of the re-paraphrasing.

Getting Started

API Keys

Get your API key at https://humanizeai.pro/the-api

Submitting a Humanization Task

To start a humanization task:

  1. Make a POST request to the / endpoint.
  2. Include the required x-api-key header for authentication.
  3. Provide the text you want to humanize as part of the request body.

Example Request:

POST / HTTP/1.1
Host: api.humanizeai.pro/v1
x-api-key: YOUR_API_KEY
Content-Type: application/json

{
  "text": "Your input text with more than 30 words goes here.",
}

Waiting for Processing

After successfully submitting a task, you will receive a unique task ID in the response. Use this ID to track the status of your request.

Retrieving the Result

  1. Make a GET request to the / endpoint.
  2. Include the x-api-key header and the task ID as a query parameter.

Example Request:

GET /?id=TASK_ID HTTP/1.1
Host: api.humanizeai.pro/v1
x-api-key: YOUR_API_KEY

Possible Responses:

  • Success: Returns the original and humanized text.
  • Processing: Indicates that the task is still being processed.
  • Failure: Provides an error message if the task failed.

Rate limits

Default rate limits are 30 requests per minute. To request more, reach out to support@humanizeai.pro