WriteHuman AI API

https://writehuman.ai/api
Admin
AI text humanizer REST API that converts AI-generated content to sound naturally human, supporting...
Tokens:2,337
Snippets:34
Trust Score:9.8
Update:4 months ago
Show doc for...
Tokens:
Raw
### API Request and Response Example

Source: https://writehuman.ai/api

A simple example showing a successful API request and its JSON response, indicating the status and words used.

```json
{ "status": "ok", "words_used": 42 }
```

--------------------------------

### Example API response for humanized text

Source: https://writehuman.ai/api/docs

This is an example of a successful response from the API for a standard plan, showing the humanized text and word usage details.

```json
{
  "results": [
    "AI has changed how we create content and communicate online."
  ],
  "input_words": 14,
  "words_remaining": {
    "included": 124986,
    "topup": 0
  }
}
```

--------------------------------

### Send a Humanization Request via REST API

Source: https://writehuman.ai/api

This example demonstrates a basic POST request to the /v1/humanize endpoint. The text to be humanized is sent in the request body as a JSON string.

```curl
fetch("/v1/humanize", { method: "POST", body: JSON.stringify({ text }) })
```

--------------------------------

### Error response for insufficient word balance

Source: https://writehuman.ai/api/docs

This response indicates that the user has run out of words in their subscription and any top-up credits.

```json
{
  "error": "Insufficient word balance",
  "words_remaining": {
    "included": 12,
    "topup": 0
  }
}
```

--------------------------------

### Error response for no active subscription

Source: https://writehuman.ai/api/docs

This JSON object indicates an error when the API key is valid but no active subscription is associated with it.

```json
{ "error": "No active subscription" }
```

--------------------------------

### Humanize Text

Source: https://writehuman.ai/api/docs

Rewrite AI-generated text to sound naturally human. This endpoint deducts input words from your balance and supports optional tone and language parameters.

```APIDOC
## POST /v1/humanize

### Description
Rewrite AI-generated text to sound naturally human. Deducts input words from your balance. Usage is tracked by input text word count. Words are deducted from your monthly subscription allowance first, then from any purchased top-up credits.

### Method
POST

### Endpoint
https://api.writehuman.ai/v1/humanize

### Parameters
#### Request Body — application/json
- **text** (string) - Required - The text to humanize. Must be between 30 and 100,000 characters.
- **tone** (string) - Optional - Optional writing tone. Omit for default style. Allowed values: professional, academic, blog, casual, creative, scientific, technical.
- **language** (string | null) - Optional - Target language (e.g. English, Spanish, Chinese (Mandarin)). Auto-detected if omitted.

### Response
#### Success Response (200)
- **results** (string[]) - Humanized text variations, sorted by score (best first).
- **scores** (number | null[]) - Human-likeness score for each result (0–1, higher = more human). Premium plans only. Omitted for Standard plans.
- **input_words** (integer) - Number of words billed for this request.
- **words_remaining** (object) - Your remaining word balance after this request. Fields: included (integer), topup (integer), total (integer).

#### Error Responses
- **401** - Missing or invalid API key.
- **403** - No active subscription.
- **422** - Invalid input, over word limit, or content blocked by moderation.
- **429** - Insufficient balance, rate limit, or concurrency limit exceeded.
- **500** - Processing failure.
```

--------------------------------

### Error response for rate limit exceeded

Source: https://writehuman.ai/api/docs

This error occurs when the number of requests exceeds the allowed rate limit for the user's plan.

```json
{ "error": "Rate limit exceeded (10 requests/minute)" }
```

--------------------------------

### Humanize Text with JavaScript API

Source: https://writehuman.ai/api

Use this JavaScript snippet to send text to the WriteHuman API for humanization. Ensure you include your API key in the Authorization header and stringify the request body.

```javascript
const { data } = await fetch("/v1/humanize", {
  method: "POST",
  headers: { "Authorization": "Bearer wh_..." },
  body: JSON.stringify({ text, tone: "general" })
}).then(r => r.json());

// => { text: "Humanized output...", words_used: 42 }
```

--------------------------------

### Humanize Text API Endpoint

Source: https://writehuman.ai/api

This endpoint allows you to humanize AI-generated text using a single POST request. It supports various tones and provides the humanized output along with usage statistics.

```APIDOC
## POST /v1/humanize

### Description
Humanizes AI-generated text by applying advanced natural language processing techniques. Supports various tones to match desired output style.

### Method
POST

### Endpoint
/v1/humanize

### Parameters
#### Request Body
- **text** (string) - Required - The AI-generated text to be humanized.
- **tone** (string) - Optional - The desired tone for the humanized text (e.g., "general", "formal", "casual"). Defaults to "general".

### Request Example
```json
{
  "text": "This is an AI-generated text that needs to be humanized.",
  "tone": "formal"
}
```

### Response
#### Success Response (200)
- **status** (string) - Indicates the success of the operation (e.g., "ok").
- **words_used** (integer) - The number of words processed in the request.
- **text** (string) - The humanized output text.

#### Response Example
```json
{
  "status": "ok",
  "words_used": 42,
  "text": "This is the humanized version of the AI-generated text."
}
```
```

--------------------------------

### Error response for exceeding per-request word limit

Source: https://writehuman.ai/api/docs

This error message is returned when the input text exceeds the maximum word limit allowed per request for the user's plan.

```json
{ "error": "Input exceeds per-request limit of 2000 words for your plan. Received ~2500 words." }
```

--------------------------------

### Error response for concurrency limit exceeded

Source: https://writehuman.ai/api/docs

This error is returned when the number of concurrent requests exceeds the maximum allowed for the user's plan.

```json
{ "error": "Too many concurrent requests (max 2)" }
```

--------------------------------

### Error response for invalid API key

Source: https://writehuman.ai/api/docs

This JSON object represents an error response when an invalid or missing API key is provided.

```json
{ "error": "Invalid API key" }
```

--------------------------------

### Error response for content moderation block

Source: https://writehuman.ai/api/docs

This error is returned if the input text is flagged by the content moderation system.

```json
{ "error": "Content blocked: sexual" }
```

--------------------------------

### Error response for general processing failure

Source: https://writehuman.ai/api/docs

This indicates a server-side error during the processing of the request.

```json
{ "error": "Processing failed" }
```
Tokens:
Raw