Di artikel sebelumnya, kita sudah bahas kenapa developer Laravel perlu peduli soal integrasi AI. Sekarang kita masuk ke praktiknya. Di artikel ini, kita akan buat koneksi yang benar-benar jalan antara aplikasi Laravel dan API AI (pakai OpenAI sebagai contoh utama, dengan catatan tambahan untuk Claude di bagian yang berbeda).

Setelah selesai baca artikel ini, kamu akan punya:

Setup
PLAINTEXT Snippetplaintext
1
.env
1 baris•4 chars
UTF-8•Spaces: 4
dan config untuk menyimpan API key dengan benar
Service class khusus untuk komunikasi ke API AI
Route/controller sederhana untuk testing
Error handling dasar biar aplikasi nggak rusak kalau API-nya gagal

Langsung saja kita mulai.

Langkah 1: Ambil API Key

Kamu butuh API key dari provider yang kamu pilih:

OpenAI: https://platform.openai.com/api-keys
Anthropic (Claude): https://console.anthropic.com/settings/keys

Simpan key ini dengan aman. Jangan pernah commit ke Git, jangan pernah hardcode langsung di kode.

Langkah 2: Simpan Key di .env

Buka file

PLAINTEXT Snippetplaintext

.env

1 baris•4 chars

UTF-8•Spaces: 4

dan tambahkan:

ENV Snippetenv

OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx

OPENAI_MODEL=gpt-4o-mini

2 baris•59 chars

UTF-8•Spaces: 4

Kalau kamu pakai Claude:

ENV Snippetenv

ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx

ANTHROPIC_MODEL=claude-sonnet-4-6

2 baris•75 chars

UTF-8•Spaces: 4

Langkah 3: Daftarkan di Config

Buka

PLAINTEXT Snippetplaintext

config/services.php

1 baris•19 chars

UTF-8•Spaces: 4

dan tambahkan entry baru:

script.phpphp

return [

// ... service lain yang sudah ada

    'openai' => [

        'key' => env('OPENAI_API_KEY'),

        'model' => env('OPENAI_MODEL', 'gpt-4o-mini'),

];

8 baris•171 chars

UTF-8•Spaces: 4

Kenapa harus lewat sini, bukan langsung panggil

PLAINTEXT Snippetplaintext

env()

1 baris•5 chars

UTF-8•Spaces: 4

di kode? Karena

PLAINTEXT Snippetplaintext

env()

1 baris•5 chars

UTF-8•Spaces: 4

cuma bisa diandalkan saat proses loading config. Begitu kamu cache config di production (

PLAINTEXT Snippetplaintext

php artisan config:cache

1 baris•24 chars

UTF-8•Spaces: 4

), pemanggilan

PLAINTEXT Snippetplaintext

env()

1 baris•5 chars

UTF-8•Spaces: 4

langsung di tempat lain di aplikasi akan mengembalikan null. Selalu ambil data rahasia lewat

PLAINTEXT Snippetplaintext

config()

1 baris•8 chars

UTF-8•Spaces: 4

Langkah 4: Buat Service Class

Daripada manggil API langsung dari controller, bungkus dulu di dalam service class. Ini bikin kode lebih rapi dan gampang kalau suatu saat mau ganti provider.

Buat file

PLAINTEXT Snippetplaintext

app/Services/AiService.php

1 baris•26 chars

UTF-8•Spaces: 4

AiService.phpphp

<?php

namespace App\Services;

use Illuminate\Support\Facades\Http;

use Illuminate\Support\Facades\Log;

class AiService

{

    public function ask(string $prompt): ?string

{

        $response = Http::withToken(config('services.openai.key'))

            ->timeout(30)

            ->post('https://api.openai.com/v1/chat/completions', [

                'model' => config('services.openai.model'),

                'messages' => [

                    ['role' => 'user', 'content' => $prompt],

],

]);

        if ($response->failed()) {

            Log::error('AI API request failed', [

                'status' => $response->status(),

                'body' => $response->body(),

]);

            return null;

}

        return $response->json('choices.0.message.content');

}

32 baris•829 chars

UTF-8•Spaces: 4

Beberapa hal yang perlu diperhatikan di sini:

PLAINTEXT Snippetplaintext
1
timeout(30)
1 baris•11 chars
UTF-8•Spaces: 4
mencegah request yang macet supaya nggak nge-hang aplikasi selamanya.
Kita cek
PLAINTEXT Snippetplaintext
1
$response->failed()
1 baris•19 chars
UTF-8•Spaces: 4
sebelum coba baca body-nya. Jangan pernah asumsikan pemanggilan API-nya pasti berhasil.
Error dicatat ke log biar bisa di-debug nanti, bukan cuma dibiarkan hilang begitu saja.

Langkah 5: Coba Pakai Route

Untuk testing cepat, tambahkan ini ke

PLAINTEXT Snippetplaintext

routes/web.php

1 baris•14 chars

UTF-8•Spaces: 4

di.phpphp

use App\Services\AiService;

Route::get('/test-ai', function (AiService $ai) {

    $result = $ai->ask('Jelaskan apa itu service class di Laravel, dalam satu paragraf singkat.');

    return $result ?? 'Ada yang salah saat memanggil API AI.';

});

7 baris•245 chars

UTF-8•Spaces: 4

Buka

PLAINTEXT Snippetplaintext

/test-ai

1 baris•8 chars

UTF-8•Spaces: 4

di browser. Kalau setup-nya benar, kamu akan lihat respons dari AI-nya.

Pakai Claude Sebagai Gantinya

Kalau kamu mau pakai Claude, format request-nya sedikit berbeda. API Anthropic pakai header

PLAINTEXT Snippetplaintext

x-api-key

1 baris•9 chars

UTF-8•Spaces: 4

dan struktur pesan yang sedikit berbeda:

script.phpphp

public function askClaude(string $prompt): ?string

{

    $response = Http::withHeaders([

            'x-api-key' => config('services.anthropic.key'),

            'anthropic-version' => '2023-06-01',

])

        ->timeout(30)

        ->post('https://api.anthropic.com/v1/messages', [

            'model' => config('services.anthropic.model'),

            'max_tokens' => 1000,

            'messages' => [

                ['role' => 'user', 'content' => $prompt],

]);

    if ($response->failed()) {

        Log::error('Claude API request failed', [

            'status' => $response->status(),

            'body' => $response->body(),

]);

        return null;

}

    return $response->json('content.0.text');

}

26 baris•752 chars

UTF-8•Spaces: 4

Jangan lupa tambahkan

PLAINTEXT Snippetplaintext

anthropic

1 baris•9 chars

UTF-8•Spaces: 4

PLAINTEXT Snippetplaintext

config/services.php

1 baris•19 chars

UTF-8•Spaces: 4

dengan cara yang sama seperti OpenAI tadi.

Kesalahan yang Sering Terjadi

1. Hardcode API key di kode Ini cara paling gampang bikin key-mu bocor kalau kodenya ternyata masuk ke repo publik. Selalu pakai

PLAINTEXT Snippetplaintext

.env

1 baris•4 chars

UTF-8•Spaces: 4

dan

PLAINTEXT Snippetplaintext

config()

1 baris•8 chars

UTF-8•Spaces: 4

2. Nggak set timeout Tanpa timeout, pemanggilan API AI yang lambat atau macet bisa bikin request nggantung tanpa batas. Selalu set timeout.

3. Manggil API langsung dari controller Ini oke buat testing cepat, tapi cepat berantakan begitu kamu butuh retry, logging, atau beberapa fitur AI sekaligus. Service class bikin kode rapi sejak awal.

4. Nggak ngecek kegagalan Provider AI bisa saja mengembalikan error, kena rate limit, atau timeout. Selalu cek

PLAINTEXT Snippetplaintext

$response->failed()

1 baris•19 chars

UTF-8•Spaces: 4

sebelum baca body response-nya.

5. Commit

PLAINTEXT Snippetplaintext

.env

1 baris•4 chars

UTF-8•Spaces: 4

ke Git Pastikan

PLAINTEXT Snippetplaintext

.env

1 baris•4 chars

UTF-8•Spaces: 4

ada di

PLAINTEXT Snippetplaintext

.gitignore

1 baris•10 chars

UTF-8•Spaces: 4

. Kalau nggak sengaja ke-commit API key-nya, langsung ganti key itu lewat dashboard provider-nya.

Selanjutnya

Sekarang kita sudah punya koneksi dasar yang jalan ke API AI. Tapi manggil langsung dari route bukan cara yang tepat buat bikin fitur beneran. Di artikel selanjutnya, kita akan pakai fondasi ini untuk bikin chatbot sederhana, termasuk cara mengelola riwayat percakapan supaya AI-nya ingat konteks dari pesan-pesan sebelumnya.

Ini adalah Part 2 dari series "Laravel + AI Integration".

Setup Integrasi OpenAI/Claude API di Laravel dari Nol

Laravel & AI Integration

Langkah 1: Ambil API Key

Langkah 2: Simpan Key di .env

Langkah 3: Daftarkan di Config

Langkah 4: Buat Service Class

Langkah 5: Coba Pakai Route

Pakai Claude Sebagai Gantinya

Kesalahan yang Sering Terjadi

Selanjutnya

Timur Dian Radha Sejati

Punya Masalah Arsitektur atau Ingin Membangun Sistem yang Benar?

Artikel Rekayasa Terkait

Dari Satu Perintah Jadi Banyak Langkah

Bikin AI yang Bisa "Baca" Website dalam Hitungan Detik

Kenalan sama GPT, Gemini, Claude, sampai yang Gratis (Ollama)