Dokumentasi API · v1

Token LiliAI untuk aplikasimu

Bayar sekali, pakai kapan saja. Saldo dipotong sesuai token yang benar-benar terpakai — tanpa langganan wajib, tanpa biaya diam.

◈ Isi saldo dulu, lalu pakai
Kunci API aktif untuk akun apa pun yang memiliki saldo. Topup mulai Rp1.000.000 lewat QRIS, saldo masuk otomatis setelah pembayaran terverifikasi.
Rp2.500 / 1.000 token
input + output digabung
Beli token sekarang Buat akun
Uji coba gratis: setiap akun mendapat 20.000 token per hari tanpa saldo. Saldo dipakai setelah jatah harian habis; minimum topup Rp1.000.000.

1. Beli token

Masuk ke akun, buka Saldo & Paket, pilih nominal, lalu pindai QRIS yang muncul. Status pembayaran diperiksa otomatis; halaman akan berubah menjadi dibayar.

NominalEstimasi token
Rp1.000.000≈ 400.000 token
Rp2.500.000≈ 1.000.000 token
Rp5.000.000≈ 2.000.000 token

Estimasi bersifat perkiraan; pemakaian nyata mengikuti panjang percakapan.

2. Buat kunci API

Kunci dibuat dari halaman Saldo & Paket → API key. Kunci hanya ditampilkan sekali di layar, berbentuk lili_sk_….

Nama: produksi
Kunci: lili_sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Simpan di secret manager atau variabel lingkungan. Jangan pernah menaruh kunci di kode frontend, repositori publik, atau aplikasi mobile yang bisa dibongkar.

3. Permintaan pertama

Satu endpoint, format yang sudah dikenal banyak SDK:

curl https://amarus.my.id/api/v1/chat/completions \
  -H "Authorization: Bearer lili_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {"role": "system", "content": "Jawab ringkas."},
      {"role": "user",   "content": "Halo, siapa kamu?"}
    ],
    "max_tokens": 300
  }'

Balasan mengikuti struktur yang sama dengan penyedia populer:

{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "model": "LiliAI Core",
  "choices": [
    {"index": 0, "message": {"role": "assistant", "content": "Halo! Aku LiliAI…"}, "finish_reason": "stop"}
  ],
  "usage": {"prompt_tokens": 24, "completion_tokens": 68, "total_tokens": 92}
}

4. Streaming

Tambahkan "stream": true untuk menerima potongan teks (SSE) secara real-time. Formatnya identik dengan OpenAI: setiap baris diawali data: dan diakhiri data: [DONE].

{"stream": true, "messages": [{"role": "user", "content": "Tulis 3 ide konten"}]}

5. Harga & kuota

PaketHargaKuota chatCatatan
FreeRp040.000 token/hari+20.000 token API/hari
ProRp499.000/bln500.000 token/harikuota API lebih besar
MaxRp1.499.000/bln2.000.000 token/harilimit tertinggi

Pemakaian API di luar kuota harian dipotong dari saldo sebesar Rp2.500 per 1.000 token.

6. Parameter yang didukung

FieldTipeKeterangan
messagesarraywajib · role: system / user / assistant
max_tokensintegerbatas panjang balasan (default 800)
streambooleanaktifkan SSE
temperaturenumber0–2, kreativitas jawaban

7. Kode galat

StatusKodeArti
401invalid_api_keykunci salah atau sudah dicabut
402saldo_habiskuota gratis dan saldo sama-sama habis
402saldo_kurangsaldo tidak cukup untuk permintaan ini
429rate_limitedterlalu banyak permintaan, tunggu sebentar
503upstream_busylayanan sedang padat, ulangi

8. Keamanan kunci

Cabut dan buat ulang kunci kapan saja dari halaman saldo. Kunci yang dicabut langsung tidak berlaku. Pembatasan laju berlaku per alamat IP agar kunci tidak disalahgunakan.

Butuh bantuan integrasi? Hubungi dukungan dari halaman akun.