Referensi API

HumanizerAI API

Integrasikan deteksi AI dan humanisasi ke dalam aplikasi Anda dengan REST API sederhana kami.

Mulai cepat

Dapatkan kunci API

Klik foto profil Anda → Pengaturan → Kunci API. Memerlukan paket Pro atau Business.

Tambahkan otorisasi

Sertakan kunci API Anda di header Authorization sebagai Bearer token.

Buat permintaan

Panggil endpoint detect atau humanize dengan konten teks Anda.

Autentikasi

Semua permintaan API memerlukan autentikasi menggunakan kunci API. Sertakan kunci Anda di header Authorization sebagai Bearer token:

Authorization: Bearer hum_your_api_key_here

Jaga keamanan kunci API Anda

Jangan pernah mengekspos kunci API Anda di kode sisi klien atau repositori publik. Gunakan variabel lingkungan.

URL dasar

https://humanizerai.com/api/v1

POST

/detect

Analisis teks untuk mendeteksi apakah ditulis oleh AI. Mengembalikan skor 0-100 (lebih tinggi = lebih mungkin AI) beserta metrik terperinci.

Badan permintaan

Parameter	Tipe	Wajib	Deskripsi
text	string		Teks yang akan dianalisis (maks 10.000 kata)

Contoh permintaan

curl -X POST https://humanizerai.com/api/v1/detect \
  -H "Authorization: Bearer hum_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Your text to analyze for AI detection..."
  }'

Respons

{
  "score": 85,
  "metrics": {
    "perplexity": 42.5,
    "burstiness": 0.35,
    "readability": 65.2,
    "satPercent": 12.5,
    "simplicity": 78.3,
    "ngramScore": 0.15,
    "averageSentenceLength": 18.4
  },
  "verdict": "likely_ai",
  "wordsProcessed": 250
}

POST

/humanize

Ubah teks yang dihasilkan AI menjadi konten alami dan manusiawi yang melewati detektor AI. Menggunakan kredit berdasarkan jumlah kata.

Badan permintaan

Parameter	Tipe	Wajib	Deskripsi
text	string		Teks yang akan dihumanisasi (maks 10.000 kata)
intensity	string	Opsional	`light`, `medium` ((default)), `aggressive` (bypass)

Tingkat intensitas

Ringan

light

Perubahan halus, mempertahankan gaya Anda. Terbaik untuk teks dengan skor AI rendah.

Sedang

medium(default)

Penulisan ulang seimbang dengan sentuhan manusia. Terbaik untuk sebagian besar kasus.

Lewati

aggressive

Bypass detektor maksimum. Teks menjadi lebih pendek dan sederhana.

Contoh permintaan

curl -X POST https://humanizerai.com/api/v1/humanize \
  -H "Authorization: Bearer hum_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Your AI-generated text to humanize...",
    "intensity": "medium"
  }'

Respons

{
  "humanizedText": "The rewritten text that sounds human...",
  "score": {
    "before": 85,
    "after": 15
  },
  "wordsProcessed": 250,
  "credits": {
    "subscriptionRemaining": 49750,
    "topUpRemaining": 0,
    "totalRemaining": 49750
  }
}

GET

/credits

Periksa saldo kredit Anda saat ini. Mengembalikan kredit langganan, kredit isi ulang, dan total tersedia.

Contoh permintaan

curl https://humanizerai.com/api/v1/credits \
  -H "Authorization: Bearer hum_your_api_key"

Respons

{
  "credits": {
    "subscription": 45000,
    "topUp": 5000,
    "total": 50000
  },
  "plan": "pro",
  "billingCycleEnd": "2025-02-15T00:00:00.000Z"
}

Kode error

Status	Pesan	Deskripsi
400	Teks wajib diisi	Parameter teks hilang atau kosong
400	Teks melebihi maksimum	Teks melebihi batas 10.000 kata
401	Kunci API wajib	Header Authorization hilang
401	Kunci API tidak valid atau dicabut	Kunci API tidak ditemukan atau telah dicabut
403	Akses API memerlukan Pro/Business	Paket pengguna tidak mencakup akses API
403	insufficient_credits	Kredit tidak cukup untuk humanisasi
500	Error server	Error internal server

Batas laju

Paket	Kunci API	Batas laju	Maks kata/permintaan
Pro	Hingga 3	60 permintaan/menit	10,000
Business	Hingga 10	300 permintaan/menit	10,000

MCP Server

Server MCP (Model Context Protocol) memberikan Claude Desktop akses langsung ke deteksi AI dan humanisasi. Minta Claude untuk memeriksa atau menghumanisasi teks tanpa meninggalkan percakapan Anda.

Instal server MCP

npm install -g @humanizerai/mcp-server

Buka konfigurasi Claude Desktop

Buka file konfigurasi di:

# macOS
~/Library/Application Support/Claude/claude_desktop_config.json

# Windows
%APPDATA%\Claude\claude_desktop_config.json

Tambahkan HumanizerAI ke konfigurasi

Tambahkan ini ke claude_desktop_config.json Anda:

{
  "mcpServers": {
    "humanizerai": {
      "command": "humanizerai-mcp",
      "env": {
        "HUMANIZERAI_API_KEY": "hum_your_api_key"
      }
    }
  }
}