# 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: 2026-11-04 · Versi HTML: https://aiport.id/id/cara-integrasi-ai-ke-website

![Ilustrasi halaman website yang terhubung ke server berkunci lalu ke API AI](https://aiport.id/images/landing/cara-integrasi-ai-ke-website/integrasi-ai-website-server-api.webp)
*Website, server milikmu, lalu API AI. Ilustrasi dibuat dengan AI.*

## Yang perlu disiapkan

| Kebutuhan | Keterangan |
| --- | --- |
| Akun AIport dengan saldo | Daftar gratis, lalu isi saldo rupiah di dashboard. |
| API key | Dibuat di halaman API keys pada dashboard. |
| Backend | Server Node.js, PHP, Python, atau fungsi serverless. Hosting statis saja tidak cukup. |
| HTTPS | Agar 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.
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.

![Halaman API keys di dashboard AIport setelah membuat key baru, dengan banner key yang hanya tampil sekali](https://aiport.id/images/landing/cara-integrasi-ai-ke-website/membuat-api-key-dashboard-aiport.webp)
*Key baru hanya tampil sekali. Akun demo, key disamarkan.*

![Form tanya jawab di website kedai kopi yang menampilkan jawaban AI tentang kopi arabika dan robusta](https://aiport.id/images/landing/cara-integrasi-ai-ke-website/form-website-dengan-jawaban-ai.webp)
*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](https://aiport.id/images/landing/cara-integrasi-ai-ke-website/diagram-api-key-aman-di-server.webp)

## 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

| Gejala | Penyebab | Solusi |
| --- | --- | --- |
| HTTP 401 `unauthorized` | API key salah, terpotong, atau sudah dihapus | Cek environment variable dan buat key baru bila perlu |
| HTTP 429 `insufficient_quota` | Saldo tidak cukup | Top up saldo di dashboard |
| HTTP 429 `too_many_inflight` | Lebih dari 5 request berjalan bersamaan | Tunggu sebentar lalu ulangi, atau antrekan request |
| Error CORS di browser | Frontend memanggil AIport secara langsung | Panggil lewat endpoint backend milikmu |
| HTTP 400 `invalid_request` | Nama field salah ketik atau nilai tidak valid | Bandingkan request dengan [dokumentasi API](https://aiport.id/docs) |

## Pertanyaan yang sering diajukan

### 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: https://aiport.id/signup · Dokumentasi: https://aiport.id/docs.md

## Halaman terkait

- [API chatbot AI](https://aiport.id/id/api-chatbot-ai)
- [API LLM Indonesia](https://aiport.id/id/api-llm-indonesia)
- [MCP server AI](https://aiport.id/id/mcp-server-ai)
