Integrasi API AI ke Laravel: Panduan Lengkap untuk Developer

Oleh Darus S Alfatah · 2025-09-13 · Tutorial · 8 menit

Integrasi API AI ke Laravel: Panduan Lengkap untuk Developer

Catatan penulis: Simpan kunci di .env dan jangan pernah menaruhnya di kode yang masuk repositori.

Fokus artikel ini

Artikel ini khusus Laravel: HTTP client, konfigurasi service, dan penanganan respons. Untuk PHP tanpa framework, lihat artikel pelengkap.

Baca juga: Cara Pakai API AI di PHP (cURL & Guzzle) untuk Pemula

Pendahuluan: Laravel dan AI

Laravel adalah framework PHP paling populer di dunia — rapi, modern, dan punya ekosistem lengkap. Mengintegrasikan API AI ke Laravel sangat cocok untuk membangun fitur seperti chatbot, generator konten, atau analisis teks. Artikel ini memandu Anda membuat integrasi yang bersih dan reusable.

Langkah 1: Install Guzzle

composer require guzzlehttp/guzzle

Langkah 2: Tambahkan Konfigurasi di .env

BANKAI_API_KEY=sk-bankai-xxxx
BANKAI_BASE_URL=https://bankai.web.id/api

Langkah 3: Buat Service Class

client = new Client([
            'base_uri' => env('BANKAI_BASE_URL'),
            'headers' => [
                'Authorization' => 'Bearer ' . env('BANKAI_API_KEY'),
                'Content-Type' => 'application/json'
            ]
        ]);
    }

    public function chat(string $prompt, string $model = 'auto')
    {
        $response = $this->client->post('/chat/completions', [
            'json' => [
                'model' => $model,
                'messages' => [
                    ['role' => 'user', 'content' => $prompt]
                ]
            ]
        ]);

        $result = json_decode($response->getBody(), true);
        return $result['choices'][0]['message']['content'] ?? null;
    }
}
?>

Langkah 4: Gunakan di Controller

use App\Services\AiService;

class AiController extends Controller
{
    public function generate(AiService $ai)
    {
        $result = $ai->chat('Buatkan 5 ide konten Instagram untuk produk skincare!');
        return response()->json(['reply' => $result]);
    }
}

Ide Fitur Laravel + AI

  • Chatbot customer service di website.
  • Generator deskripsi produk otomatis.
  • Ringkasan artikel dan dokumen.
  • Asisten admin internal.

Integrasikan Laravel Anda dengan All in One API Key BankAI dan tambahkan kecerdasan AI dalam hitungan menit!

Service Class untuk Memisahkan Logika

Jangan memanggil API model langsung dari controller. Buat satu service class yang menangani pemanggilan, retry, dan logging, lalu inject ke controller. Dengan begitu, mengganti model atau penyedia hanya mengubah satu kelas, dan pengujian menjadi lebih mudah.

class AiService {
    public function ask(array $messages, int $maxTokens = 600): string
    {
        $res = Http::withToken(config('services.bankai.key'))
            ->timeout(60)
            ->retry(2, 500)
            ->post(config('services.bankai.base') . '/v1/chat/completions', [
                'model' => 'auto',
                'messages' => $messages,
                'max_tokens' => $maxTokens,
            ]);
        $res->throw();
        return data_get($res->json(), 'choices.0.message.content', '');
    }
}

Konfigurasi dan Cache

Simpan kunci di config/services.php yang membaca env, lalu jalankan php artisan config:cache di produksi. Untuk pertanyaan yang sering berulang, bungkus hasilnya dengan Cache::remember selama beberapa jam. Ini bisa memotong biaya hingga separuh pada aplikasi dukungan pelanggan.

Antrian untuk Tugas Berat

Untuk pemrosesan dokumen atau ringkasan massal, gunakan queue job agar request web tidak menunggu lama. Laravel Horizon membantu memantau kegagalan dan waktu proses. Tetapkan timeout job lebih besar daripada timeout HTTP, dan tangani kegagalan dengan notifikasi agar tidak ada pekerjaan yang hilang diam-diam.

Menguji Tanpa Memanggil API Sungguhan

Pengujian yang memanggil API nyata lambat, mahal, dan tidak deterministik. Laravel menyediakan Http::fake untuk mengembalikan respons palsu, sehingga test berjalan cepat dan stabil. Buat fixture berisi respons sukses, respons error, dan respons dengan format menyimpang, lalu pastikan aplikasi menanganinya dengan benar.

Selain test otomatis, lakukan uji manual pada jalur kritis sebelum rilis: kirim pertanyaan normal, pertanyaan sangat panjang, dan pertanyaan yang memicu penolakan model. Tiga skenario ini menangkap sebagian besar masalah integrasi.

Observability Sederhana

Catat setiap panggilan ke channel log terpisah berisi model, durasi, jumlah token, dan status. Dengan data ini Anda bisa menjawab pertanyaan seperti "fitur mana yang paling mahal" tanpa menebak. Tinjau log setiap minggu pada awal peluncuran, lalu bulanan setelah stabil.

Untuk tim kecil, satu halaman dashboard berisi total biaya harian dan jumlah error sudah cukup untuk mencegah kejutan di akhir bulan.

Form Request dan Validasi

class ChatRequest extends FormRequest {
    public function rules(): array {
        return [
            'pesan' => ['required', 'string', 'max:4000'],
            'model' => ['nullable', 'in:auto,murah,besar'],
        ];
    }
}

Validasi mencegah payload besar yang menghabiskan kuota. Batasi juga jumlah percakapan per menit menggunakan middleware throttle.

Menangani Timeout dengan Anggun

Ketika penyedia lambat, pengguna sebaiknya mendapat pesan yang jelas dan tombol coba lagi. Untuk proses panjang, pindahkan ke queue dan beri notifikasi ketika selesai. Ini jauh lebih baik daripada halaman yang berputar tanpa kepastian.

Migrasi dan Konfigurasi

Simpan pengaturan model di file konfigurasi, bukan di database, agar mudah diubah lewat environment. Jalankan php artisan config:cache di produksi dan pastikan tidak ada kunci yang tertulis di kode.

Pertanyaan yang Sering Ditanyakan

Di mana sebaiknya menyimpan kunci API? Di environment server, dibaca melalui config. Jangan di database atau file yang di-commit.

Bagaimana menguji tanpa memanggil API nyata? Gunakan Http::fake dan fixture respons. Buat kasus sukses, error, dan format menyimpang.

Kapan perlu memakai queue? Ketika proses lebih dari beberapa detik atau memproses banyak dokumen. Request web sebaiknya tetap responsif.

Contoh konfigurasi aman: Simpan kunci di config/services.php dari .env, panggil lewat service class, dan jangan pernah menaruhnya di blade atau JavaScript.

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.

Sumber & Referensi

Tentang penulis

Darus S Alfatah — Founder & Penulis

Darus S Alfatah adalah pendiri BankAI. Ia membangun dan mengoperasikan gateway API LLM yang melayani developer Indonesia, dan menulis tentang integrasi LLM, arsitektur gateway, serta cara memakai AI secara praktis dan hemat biaya. Setiap panduan diuji di lingkungan nyata — termasuk kode, konfigurasi, dan perhitungan token — sebelum diterbitkan, dan diperbarui ketika dokumentasi penyedia atau harga berubah.

Kebijakan editorial

Artikel terkait

🚀 Siap Pakai All in One API Key?

Daftar sekarang, top-up pakai QRIS, dan langsung ngoding pake ChatGPT, Claude, DeepSeek & semua AI dalam satu API Key!

🔑 DAFTAR SEKARANG · Harga