Apa itu API AI? Panduan Lengkap untuk Pemula [+ Contoh Kode]

API AI vs aplikasi chat

Konsep penting: token

Model AI tidak menghitung kata, melainkan token — potongan teks yang bisa berupa satu kata utuh, bagian kata, atau tanda baca. Kalimat bahasa Indonesia biasanya dipecah menjadi lebih banyak token daripada jumlah katanya.

Ada dua jenis token yang ditagih:

• Token input: prompt yang kamu kirim, termasuk instruksi sistem dan riwayat percakapan.
• Token output: jawaban yang dihasilkan model. Harganya biasanya lebih mahal daripada input.

Harga umumnya ditulis per 1 juta token. Misalnya, kalau sebuah model berharga Rp500 per 1 juta token input dan kamu mengirim prompt sebanyak 2.000 token, biaya inputnya adalah 2.000 ÷ 1.000.000 × Rp500 = Rp1. Cara yang sama berlaku untuk output.

Cara kerja satu request

1. Aplikasimu mengirim request ke alamat API (base URL) dengan API key di header.
2. Body request berisi nama model, daftar pesan, dan pengaturan seperti batas panjang jawaban.
3. Server API meneruskan request ke model, lalu mengembalikan jawaban beserta jumlah token yang dipakai.
4. Biaya dihitung dari token input dan output, lalu dipotong dari saldo atau kuota paketmu.

Contoh request pertama

Sebagian besar API AI saat ini memakai format yang kompatibel dengan OpenAI. Contoh di bawah memakai Classai Router; untuk penyedia lain, cukup ganti base URL dan API key.

curl https://router.classai.id/v1/chat/completions \
  -H "Authorization: Bearer $CLASSAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "Jelaskan API dalam satu kalimat."}],
    "max_tokens": 200
  }'

Dengan Python, kamu bisa memakai SDK resmi OpenAI dan hanya mengganti alamatnya:

import os
from openai import OpenAI

client = OpenAI(base_url="https://router.classai.id/v1", api_key=os.environ["CLASSAI_API_KEY"])
reply = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Buat 3 ide judul artikel tentang kopi."}],
    max_tokens=300,
)
print(reply.choices[0].message.content)

Contoh JavaScript, streaming, dan format Anthropic ada di panduan gratis yang bisa kamu unduh di halaman ini.

Memilih model yang tepat

• Model kecil dan cepat cocok untuk klasifikasi, ekstraksi data, ringkasan pendek, dan chatbot sederhana. Biayanya sangat rendah.
• Model besar cocok untuk penalaran rumit, coding, dan tulisan yang menuntut kualitas tinggi.
• Mulai dari model kecil, lalu naik hanya jika kualitasnya belum cukup. Banyak aplikasi tidak butuh model paling mahal.

Daftar model beserta harganya per 1 juta token bisa kamu lihat di halaman model Classai Router.

Keamanan API key

API key sama berharganya dengan kartu ATM: siapa pun yang memegangnya bisa memakai saldomu.

• Simpan key di environment variable di server, jangan di dalam kode.
• Jangan pernah menaruh key di aplikasi frontend, aplikasi mobile, atau repositori publik.
• Pakai key terpisah untuk setiap aplikasi, supaya mudah dilacak dan dinonaktifkan bila bocor.

Kesalahan umum pemula

• Tidak memasang max_tokens, sehingga jawaban bisa sangat panjang dan mahal.
• Mengirim seluruh riwayat percakapan tanpa batas.
• Tidak menangani error 429 (terlalu banyak request) dengan jeda dan percobaan ulang.
• Langsung memakai model paling besar untuk semua tugas.

Langkah berikutnya

Cara tercepat memahami API adalah mencobanya. Classai Router memberi satu API key untuk Claude, GPT, Gemini, DeepSeek, dan model lain — bayar per token dengan Rupiah lewat QRIS, Virtual Account, atau e-wallet, tanpa kartu kredit. Dokumentasinya ada di https://router.classai.id/docs. Ingin belajar membangun aplikasi AI secara terstruktur? Lihat kelas AI untuk Developer.