Dokumentasi API

Satu endpoint,tanpa API key.

Sambungkan Kev-Ai ke bot WhatsApp, website, atau aplikasimu sendiri dengan satu request HTTP.

Ringkasan

API Kev-Ai menerima pesan teks dan mengembalikan jawaban dalam JSON. Tidak perlu login atau API key, CORS terbuka untuk semua domain, dan Kev-Ai tidak memasang batas jumlah request. Percakapan berlanjut lewat sessionId, jadi server tidak menyimpan data apa pun.

Endpoint

GET/api/aiPOST/api/ai

Alias /ai juga berfungsi dan mengarah ke endpoint yang sama. Pakai POST untuk percakapan panjang karena sessionId bisa terlalu panjang untuk URL.

Contoh GET

GET /api/ai?text=Halo+Kev-Ai

Parameter

Kirim lewat query string (GET) atau body JSON (POST). Nilai di body menimpa query.

Nama	Tipe	Keterangan
`text`wajib	string	Pesan untuk Kev-Ai. Bisa diganti dengan `prompt`.
`prompt`	string	Alias dari `text`.
`sessionId`	string	Dari balasan sebelumnya, untuk melanjutkan percakapan yang sama.
`model`	string	Pilih model: `auto` (default), `claude-haiku`, `qwen3`, `gpt`, `unlimited`, `gemini`, `notrack`, atau karakter seperti `kobo-ai`. Daftar lengkap di `/api/models`.
`strict`	boolean	Isi `1` agar hanya memakai model pilihan, tanpa pindah ke model lain saat gagal.
`system`	string	Instruksi sistem untuk mengatur gaya jawaban. Kosong = bawaan Kev-Ai.

Respons

Semua balasan berupa JSON. Jika status bernilai true, jawabannya ada di result (teks markdown).

Berhasil · 200

{
  "status": true,
  "creator": "Kev",
  "result": "Halo! Ada yang bisa kubantu?",
  "sessionId": "eyJyZXN1bWVBcnJheSI6Wy4uLl19"
}

Gagal · 400 / 500

{
  "status": false,
  "creator": "Kev",
  "error": "Parameter \"text\" atau \"prompt\" wajib diisi.",
  "usage": "/api/ai?text=Halo+Kev-Ai"
}

Melanjutkan sesi

Setiap balasan membawa sessionId baru. Kirim kembali di request berikutnya agar Kev-Ai ingat konteks. Tanpa sessionId, setiap request dianggap percakapan baru.

Alur sesi

// 1) pesan pertama: tanpa sessionId
POST /api/ai   { "text": "Namaku Dimas" }
→ { "status": true, "result": "...", "sessionId": "AAA" }

// 2) pesan berikutnya: kirim sessionId dari balasan sebelumnya
POST /api/ai   { "text": "Siapa namaku?", "sessionId": "AAA" }
→ { "status": true, "result": "Namamu Dimas.", "sessionId": "BBB" }

// 3) selalu pakai sessionId terbaru (BBB, lalu seterusnya)

Kode status & error

Status	Arti	Yang perlu dilakukan
`200`	Berhasil	Ambil jawaban dari `result`.
`400`	`text` / `prompt` kosong	Isi parameter `text`.
`500`	Gagal memproses atau membaca jawaban	Coba lagi. Jika terus terjadi, mulai sesi baru tanpa `sessionId`.

Respons AI bisa memakan waktu beberapa detik, jadi atur timeout klien minimal 60 detik.

Contoh kode

cURL · bash

# GET
curl "https://kev-ai.vercel.app/api/ai?text=Halo+Kev-Ai"

# POST (disarankan, terutama untuk sesi)
curl -X POST https://kev-ai.vercel.app/api/ai \
  -H "Content-Type: application/json" \
  -d '{"text":"Jelaskan closure di JavaScript"}'

Coba langsung

Kirim request sungguhan ke endpoint ini dari browser. Hasilnya ditampilkan apa adanya.

Parameter text

Lanjutkan sesi sebelumnya (belum ada)

Lebih suka antarmuka chat? Buka /chat.