Cara Pakai API AI di PHP (cURL & Guzzle) untuk Pemula
Oleh Darus S Alfatah · 2025-09-12 · Tutorial · 8 menit
Catatan penulis: Di PHP, cURL sering lupa menaikkan time out untuk model besar; nilai bawaannya terlalu singkat.
Fokus artikel ini
Artikel ini khusus PHP native: cURL dan Guzzle, tanpa framework. Untuk versi Laravel, lihat artikel pelengkap.
Baca juga: Integrasi API AI ke Laravel: Panduan Lengkap untuk Developer
Pendahuluan: PHP dan API AI
PHP masih menjadi bahasa backend yang paling banyak dipakai untuk website di Indonesia — WordPress, Laravel, CodeIgniter, sampai custom CMS. Menambahkan kemampuan AI ke aplikasi PHP sebenarnya sangat mudah: cukup kirim HTTP request ke endpoint API AI. Artikel ini menunjukkan dua cara populer: pakai cURL (tanpa library tambahan) dan Guzzle (HTTP client modern).
Persiapan
- Pastikan PHP 7.4+ terinstall.
- Daftar di bankai.web.id dan salin API key.
Cara 1: Menggunakan cURL
'auto',
'messages' => [
['role' => 'user', 'content' => 'Halo, perkenalkan dirimu!']
]
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Bearer ' . $api_key
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
echo $result['choices'][0]['message']['content'] ?? 'Error';
?>
Cara 2: Menggunakan Guzzle
composer require guzzlehttp/guzzle
post('https://bankai.web.id/api/chat/completions', [
'headers' => [
'Authorization' => 'Bearer sk-bankai-xxxx',
'Content-Type' => 'application/json'
],
'json' => [
'model' => 'auto',
'messages' => [
['role' => 'user', 'content' => 'Jelaskan cara kerja API AI!']
]
]
]);
$result = json_decode($response->getBody(), true);
echo $result['choices'][0]['message']['content'];
?>
Tips untuk Produksi
- Simpan API key di environment variable, jangan hardcode.
- Pasang timeout agar request tidak menggantung.
- Gunakan
try-catchuntuk menangani error jaringan. - Manfaatkan model
autountuk fleksibilitas.
Dengan All in One API Key BankAI, aplikasi PHP Anda langsung bisa memakai 10+ model AI. Mulai Rp 2.000!
Contoh Implementasi Lengkap
Berikut kerangka fungsi PHP yang aman dipakai ulang di beberapa proyek. Perhatikan timeout, penanganan error, dan pemisahan kunci ke environment.
function tanyaAI(string $prompt): string {
$payload = json_encode([
'model' => 'auto',
'messages' => [['role' => 'user', 'content' => $prompt]],
'max_tokens' => 600
]);
$ch = curl_init('https://bankai.web.id/api/v1/chat/completions');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $payload,
CURLOPT_TIMEOUT => 60,
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'Authorization: Bearer ' . getenv('BANKAI_API_KEY')
]
]);
$res = curl_exec($ch);
if ($res === false) { throw new RuntimeException(curl_error($ch)); }
curl_close($ch);
$data = json_decode($res, true);
return $data['choices'][0]['message']['content'] ?? '';
}
Tips Produksi
Aktifkan verifikasi SSL dan jangan menonaktifkannya hanya untuk mengatasi error sertifikat. Simpan respons ke cache untuk pertanyaan yang sama, karena banyak aplikasi menerima pertanyaan berulang. Bungkus pemanggilan dalam blok try-catch agar kegagalan API tidak menampilkan error mentah ke pengguna.
Deployment di Shared Hosting
Banyak hosting PHP membatasi waktu eksekusi 30 detik. Untuk jawaban panjang, gunakan streaming atau proses latar belakang. Periksa juga izin akses keluar (outbound) — sebagian hosting blokir koneksi ke domain tertentu.
Struktur Proyek yang Rapi
Pisahkan konfigurasi, klien HTTP, dan logika bisnis ke file berbeda. Konfigurasi membaca environment, klien menangani permintaan dan error, sedangkan logika bisnis cukup memanggil fungsi sederhana. Pemisahan ini memudahkan pengujian dan mencegah kunci API tersebar di banyak file.
Untuk proyek yang memakai framework, manfaatkan HTTP client bawaan yang sudah menangani retry dan timeout. Jika tetap memakai cURL langsung, bungkus dalam satu kelas agar tidak ada duplikasi pengaturan header di banyak tempat.
Menangani Respons Tidak Terduga
Anggap setiap respons bisa berbentuk lain dari yang diharapkan. Periksa status kode, pastikan struktur JSON sesuai, dan sediakan nilai cadangan ketika jawaban kosong. Aplikasi yang mengasumsikan respons selalu sempurna akan gagal pada saat paling tidak tepat, biasanya ketika trafik sedang tinggi.
Catat durasi setiap panggilan. Jika rata-rata mendekati batas waktu, naikkan timeout atau pindahkan proses ke antrian latar belakang agar pengguna tidak menunggu terlalu lama di halaman.
Menyimpan Hasil ke Cache
$key = 'ai:' . md5($prompt);
if ($cached = apcu_fetch($key)) return $cached;
$hasil = tanyaAI($prompt);
apcu_store($key, $hasil, 3600);
return $hasil;
Cache sederhana ini memotong biaya untuk pertanyaan berulang, yang jumlahnya sering lebih dari separuh total permintaan pada aplikasi dukungan pelanggan.
Menghindari Timeout Hosting
Jika hosting membatasi 30 detik, pecah jawaban panjang atau gunakan proses antrian. Selalu tangani kegagalan dengan pesan yang bisa ditindaklanjuti pengguna.
Audit Log
Catat durasi dan status setiap panggilan. Data ini membantu menemukan jam sibuk dan memutuskan kapan perlu menaikkan batas waktu.
Contoh timeout cukup: Model besar bisa butuh puluhan detik. Setel CURLOPT_TIMEOUT ke nilai yang cukup, misalnya enam puluh detik, agar tidak putus di tengah.
Pertanyaan yang Sering Diajukan
Apakah tutorial ini bisa diikuti pemula?
Ya. Langkah-langkahnya dijelaskan berurutan dan menyertakan contoh kode, jadi bisa diikuti pemula maupun developer berpengalaman.
Apakah endpoint BankAI kompatibel dengan library yang sudah saya pakai?
Ya, BankAI 100% kompatibel dengan standar OpenAI, sehingga library seperti OpenAI SDK, LangChain, dan tools sejenis bisa dipakai tanpa mengubah kode selain Base URL dan API key.
Di mana saya mendapatkan API key untuk mengikuti tutorial ini?
API key (dan Secret Token) didapat setelah daftar dan menyelesaikan pembayaran di dashboard BankAI.