composer require hosseinhezami/laravel-gemini

php artisan vendor:publish --tag=gemini-config

GEMINI_API_KEY=your_gemini_api_key_here

use HosseinHezami\LaravelGemini\Facades\Gemini;

// Yêu cầu đơn giản
$response = Gemini::text()
    ->prompt('Viết một câu slogan cho blog lập trình viên.')
    ->generate();

echo $response->content();

// Trò chuyện với lịch sử
$history = [
    ['role' => 'user', 'parts' => [['text' => 'Xin chào!']]],
    ['role' => 'model', 'parts' => [['text' => 'Chào bạn! Tôi có thể giúp gì?']]]
];

$response = Gemini::text()
    ->prompt('Thời tiết hôm nay thế nào?')
    ->history($history)
    ->temperature(0.7)
    ->generate();

echo $response->content();

$response = Gemini::text()
    ->structuredSchema([
        'type' => 'object',
        'properties' => [
            'sentiment' => [
                'type' => 'string',
                'enum' => ['positive', 'negative', 'neutral']
            ],
            'confidence' => ['type' => 'number'],
            'key_points' => [
                'type' => 'array',
                'items' => ['type' => 'string']
            ]
        ],
        'required' => ['sentiment']
    ])
    ->prompt('Sản phẩm rất tuyệt nhưng giao hàng thì chậm. Tôi rất thích các tính năng.')
    ->generate();

$analysis = json_decode($response->content());
// $analysis->sentiment, $analysis->key_points, v.v.

$response = Gemini::image()
    ->prompt('Một logo tối giản cho một startup công nghệ gọi là "Nexus", sử dụng màu xanh và xanh lá cây')
    ->generate();

// Lưu hình ảnh đã tạo trực tiếp
$response->save(storage_path('app/logo.png'));

// Đầu tiên, tải lên file đến máy chủ của Gemini
$fileUri = Gemini::files()->upload('document', $pathToInvoicePdf);

// Sau đó, sử dụng nó trong một lời nhắc
$response = Gemini::text()
    ->upload('document', $pathToInvoicePdf) // hoặc sử dụng $fileUri
    ->prompt('Tổng số tiền phải trả trên hóa đơn này là bao nhiêu?')
    ->generate();

echo $response->content();

$response = Gemini::audio()
    ->prompt('Chào mừng bạn đến với ứng dụng của chúng tôi. Chúng tôi rất vui khi có bạn.')
    ->voiceName('Kore') // Kiểm tra tài liệu để biết các giọng nói có sẵn
    ->generate();

// Package này xử lý thông minh phản hồi nhị phân,
// cho phép bạn lưu trực tiếp.
$response->save(public_path('audio/welcome.mp3'));

// Trong controller của bạn (ví dụ: app/Http/Controllers/ChatController.php)
public function stream(Request $request)
{
    return response()->stream(function () use ($request) {
        Gemini::text()
            ->model('gemini-2.5-flash-lite') // Sử dụng một mô hình nhanh cho việc phát trực tiếp
            ->prompt($request->query('message'))
            ->stream(function ($chunk) {
                $text = $chunk['text'] ?? '';
                if (connection_aborted()) return;
                echo "data: " . json_encode(['text' => $text]) . "\n\n";
                ob_flush();
                flush();
            });
    }, 200, [
        'Content-Type' => 'text/event-stream',
        'Cache-Control' => 'no-cache',
        'Connection' => 'keep-alive',
        'X-Accel-Buffering' => 'no',
    ]);
}