API documentation

HumanizeRU API for humanization, detection, and style workflows.

Create an API key in the Dashboard.

Agent API

Give agents a stable writing layer: humanization, style presets, saved private styles, and style extraction.

Authentication

Pass an API key with Authorization: Bearer hru_your_key. Saved styles require an API key or an active account session.

Use a preset style

curl -X POST https://humanizeru.com/api/humanize \
  -H "Authorization: Bearer hru_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Your text with at least 50 characters...",
    "tone": "conversational",
    "style_preset": "technical_programmer",
    "style_strength": "balanced",
    "style_adjustments": {
      "technicality": "high",
      "warmth": "medium"
    }
  }'

Extract a style profile

curl -X POST https://humanizeru.com/api/styles/extract \
  -H "Authorization: Bearer hru_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "sample": "A style sample with at least 120 characters..."
  }'

Ready-made style bases

curl https://humanizeru.com/api/style-presets

Use a saved private style

curl -X POST https://humanizeru.com/api/humanize \
  -H "Authorization: Bearer hru_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Your text with at least 50 characters...",
    "style_id": "saved-style-id",
    "style_strength": "balanced"
  }'

AI text detection

curl -X POST https://humanizeru.com/api/detect \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Text to check..."
  }'

Error handling

The API returns stable codes such as INVALID_API_KEY, TEXT_TOO_SHORT, STYLE_SAMPLE_TOO_SHORT, and STYLE_NOT_FOUND.

Full documentation