TUTORIAL

Cara integrasi AI ke website, langkah demi langkah

Cara integrasi AI ke website: buat API key, simpan di server (bukan di JavaScript browser), buat satu endpoint backend yang meneruskan permintaan ke /v1/chat/completions, lalu panggil endpoint itu dari halaman web. Contoh lengkap untuk Node.js, PHP, dan Python ada di bawah.

Diperbarui

Ilustrasi halaman website yang terhubung ke server berkunci lalu ke API AI
Website, server milikmu, lalu API AI. Ilustrasi dibuat dengan AI.

Yang perlu disiapkan

KebutuhanKeterangan
Akun AIport dengan saldoDaftar gratis, lalu isi saldo rupiah di dashboard.
API keyDibuat di halaman API keys pada dashboard.
BackendServer Node.js, PHP, Python, atau fungsi serverless. Hosting statis saja tidak cukup.
HTTPSAgar data pengguna terenkripsi saat dikirim ke server-mu.

Langkah integrasi

1

Buat API key

Buka Dashboard → API keys, lalu buat key baru. Key hanya ditampilkan sekali, jadi salin dan simpan saat itu juga.

Halaman API keys di dashboard AIport setelah membuat key baru, dengan banner key yang hanya tampil sekali
Key baru hanya tampil sekali. Akun demo, key disamarkan.
2

Simpan di environment variable

Simpan sebagai AIPORT_API_KEY di server. Jangan menaruhnya di kode yang di-commit atau di file JavaScript publik.

3

Buat endpoint backend

Satu route, misalnya POST /api/ai, yang menerima input pengguna lalu memanggil AIport. Contoh kode untuk tiga bahasa ada di bawah.

4

Panggil dari halaman web

Frontend memanggil endpoint milikmu dengan fetch, lalu menampilkan jawabannya.

Form tanya jawab di website kedai kopi yang menampilkan jawaban AI tentang kopi arabika dan robusta
Situs contoh. Jawabannya respons asli dari API AIport.

Kenapa API key tidak boleh ada di frontend

Semua yang dikirim ke browser bisa dilihat siapa pun lewat View Source atau DevTools. Kalau API key ada di JavaScript, orang lain bisa memakainya dan menghabiskan saldomu.

Kalau key terlanjur bocor, hapus key itu di Dashboard → API keys dan buat yang baru. Key yang dihapus langsung tidak bisa dipakai.

Perbandingan API key di JavaScript browser yang bisa dicuri dan API key di server yang aman

Kode backend dan frontend

Node.js (Express)
app.post("/api/ai", async (req, res) => {
  const r = await fetch("https://aiport.id/v1/chat/completions", {
    method: "POST",
    headers: {
      Authorization: "Bearer " + process.env.AIPORT_API_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: "deepseek-v4-flash",
      messages: [{ role: "user", content: String(req.body.question).slice(0, 2000) }],
    }),
  });
  const data = await r.json();
  res.json({ answer: data.choices?.[0]?.message?.content ?? "" });
});
PHP (cURL)
<?php
$input = json_decode(file_get_contents('php://input'), true);
$payload = json_encode([
  'model' => 'deepseek-v4-flash',
  'messages' => [['role' => 'user', 'content' => mb_substr($input['question'] ?? '', 0, 2000)]],
]);

$ch = curl_init('https://aiport.id/v1/chat/completions');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('AIPORT_API_KEY'),
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS => $payload,
]);
$data = json_decode(curl_exec($ch), true);
header('Content-Type: application/json');
echo json_encode(['answer' => $data['choices'][0]['message']['content'] ?? '']);
Python (Flask)
import os, requests
from flask import Flask, request, jsonify

app = Flask(__name__)

@app.post("/api/ai")
def ai():
    question = str(request.json.get("question", ""))[:2000]
    r = requests.post(
        "https://aiport.id/v1/chat/completions",
        headers={"Authorization": "Bearer " + os.environ["AIPORT_API_KEY"]},
        json={"model": "deepseek-v4-flash",
              "messages": [{"role": "user", "content": question}]},
        timeout=120,
    )
    answer = r.json()["choices"][0]["message"]["content"]
    return jsonify(answer=answer)
Frontend (JavaScript)
const res = await fetch("/api/ai", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ question: document.querySelector("#q").value }),
});
const { answer } = await res.json();
document.querySelector("#answer").textContent = answer;

Batasi panjang input (contoh di atas memotong di 2.000 karakter) dan tambahkan rate limit per pengguna di endpoint-mu agar biaya tidak membengkak.

Troubleshooting

GejalaPenyebabSolusi
HTTP 401 unauthorizedAPI key salah, terpotong, atau sudah dihapusCek environment variable dan buat key baru bila perlu
HTTP 429 insufficient_quotaSaldo tidak cukupTop up saldo di dashboard
HTTP 429 too_many_inflightLebih dari 5 request berjalan bersamaanTunggu sebentar lalu ulangi, atau antrekan request
Error CORS di browserFrontend memanggil AIport secara langsungPanggil lewat endpoint backend milikmu
HTTP 400 invalid_requestNama field salah ketik atau nilai tidak validBandingkan request dengan dokumentasi API

Pertanyaan seputar cara integrasi AI ke website

Apakah AI bisa dipanggil langsung dari JavaScript di browser?

Jangan. API key akan terlihat oleh siapa pun yang membuka halaman. Panggil AIport dari backend, lalu frontend memanggil backend-mu.

Bahasa pemrograman apa yang bisa dipakai?

Bahasa apa pun yang bisa mengirim HTTP request: Node.js, PHP, Python, Go, Java, dan lainnya. Halaman ini memberi contoh untuk tiga yang paling umum.

Bagaimana kalau API key saya bocor?

Hapus key tersebut di Dashboard → API keys dan buat key baru. Key yang dihapus langsung berhenti berfungsi.

Apakah website dengan hosting statis bisa memakai AI?

Bisa, asalkan ada lapisan backend, misalnya fungsi serverless, yang menyimpan API key dan meneruskan request ke AIport.

Pasang AI di website-mu hari ini

Buat API key, salin contoh kode, dan jalankan endpoint pertamamu.

Daftar gratis →Lihat dokumentasi