Laravel 整合 OpenAI API 實現 AI 內容生成：完整實作教學

為什麼要在 Laravel 中使用 AI 內容生成？

在現代網頁應用中，AI 內容生成已成為提升用戶體驗的重要工具。透過 Laravel 整合 OpenAI，開發者可以自動化產生部落格文章、產品描述、客服回覆等內容，大幅提升內容產出效率。 傳統的同步 API 呼叫會造成用戶等待時間過長，影響使用者體驗。本教學將採用 Laravel Queue 機制，將 AI 生成的運算密集任務移至背景處理，讓前端頁面能夠立即回應，同時透過非同步 job 執行長時間的 AI 運算。 這種架構特別適合以下場景：自動產生 SEO 優化的文章草稿、批次生成產品說明、智慧客服系統的回覆建議等。

環境準備與基本設定

在開始之前，請確保您的開發環境滿足以下條件：

• PHP 8.1 以上版本
• Laravel 10 或更新版本
• OpenAI API Key（需至 OpenAI 官網申請）
• 資料庫（MySQL 或 PostgreSQL）

首先，建立新的 Laravel 專案並安裝必要的套件：

composer create-project laravel/laravel ai-content-generator
cd ai-content-generator
composer require openai-php/laravel
php artisan vendor:publish --provider="OpenAI\Laravel\OpenAIServiceProvider"

接下來，在 `.env` 檔案中設定 OpenAI API Key：

OPENAI_API_KEY=your-api-key-here

確認 `.env` 設定正確後，您可以透過以下指令驗證連線是否正常。

建立 OpenAI 服務類別

為了讓程式碼更具結構性，我們建立一個專門處理 AI 生成的服務類別。在 `app/Services` 目錄下建立 `ContentGeneratorService.php`：

<?php

namespace App\Services;

use OpenAI\Laravel\Facades\OpenAI;

class ContentGeneratorService
{
    public function generate(string $prompt, string $model = 'gpt-3.5-turbo'): string
    {
        $result = OpenAI::chat()->create([
            'model' => $model,
            'messages' => [
                ['role' => 'user', 'content' => $prompt]
            ],
            'max_tokens' => 1000,
            'temperature' => 0.7,
        ]);

        return $result->choices[0]->message->content;
    }

    public function generateBlogPost(string $title, string $keywords): string
    {
        $prompt = "請根據以下標題和關鍵詞，撰寫一篇 SEO 優化的部落格文章：\n標題：{$title}\n關鍵詞：{$keywords}";
        
        return $this->generate($prompt);
    }
}

這個服務類別封裝了 OpenAI API 的呼叫邏輯，並提供 `generateBlogPost` 方法方便產生部落格文章。您可以根據需求擴充其他生成方法，如產品描述、社交媒體貼文等。

使用 Queue 處理非同步生成

為了避免用戶長時間等待 AI 回應，我們使用 Laravel Queue 將生成任務移至背景執行。首先，建立一個專門的 Job 類別：

php artisan make:job GenerateContentJob

編輯 `app/Jobs/GenerateContentJob.php`：

<?php

namespace App\Jobs;

use App\Services\ContentGeneratorService;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Queue\SerializesModels;

class GenerateContentJob implements ShouldQueue
{
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;

    public int $tries = 3;
    public int $timeout = 120;

    public function __construct(
        public int $postId,
        public string $title,
        public string $keywords
    ) {}

    public function handle(ContentGeneratorService $generator): void
    {
        $content = $generator->generateBlogPost($this->title, $this->keywords);
        
        // 儲存生成的內容到資料庫
        \App\Models\Post::where('id', $this->postId)->update([
            'content' => $content,
            'ai_generated' => true,
            'generated_at' => now(),
        ]);
    }

    public function failed(\Throwable $exception): void
    {
        \App\Models\Post::where('id', $this->postId)->update([
            'generation_error' => $exception->getMessage(),
        ]);
    }
}

在控制器中調用這個 Job：

use App\Jobs\GenerateContentJob;
use App\Models\Post;

public function generateContent(Request $request)
{
    $post = Post::create([
        'title' => $request->title,
        'keywords' => $request->keywords,
        'status' => 'pending',
    ]);

    GenerateContentJob::dispatch($post->id, $post->title, $post->keywords);

    return response()->json([
        'message' => '內容生成任務已提交',
        'post_id' => $post->id,
    ]);
}

這樣用戶提交請求後會立即收到回應，而 AI 內容生成則在背景處理。

前端整合與實際應用

最後，讓我們建立前端表單來觸發 AI 內容生成。建立 Blade 視圖 `resources/views/admin/posts/create.blade.php`：

<form action="{{ route('posts.generate') }}" method="POST">
    @csrf
    <div>
        <label>文章標題</label>
        <input type="text" name="title" required>
    </div>
    <div>
        <label>關鍵詞（用逗號分隔）</label>
        <input type="text" name="keywords" required>
    </div>
    <button type="submit">AI 生成內容</button>
</form>

<div id="status"></div>

<script>
function checkStatus(postId) {
    fetch(`/posts/${postId}/status`)
        .then(res => res.json())
        .then(data => {
            if (data.status === 'completed') {
                document.getElementById('status').innerHTML = '內容已生成完成！';
            } else {
                setTimeout(() => checkStatus(postId), 3000);
            }
        });
}
</script>

您可以透過 Laravel Echo 或 AJAX 輪詢即時更新生成狀態，讓管理員能夠追蹤內容產出的進度。

總結與建議

本教學介紹了如何在 Laravel 中整合 OpenAI API 並使用 Queue 機制實現非同步 AI 內容生成。這種架構不僅提升用戶體驗，還能有效控制 API 呼叫成本。 實際應用時，建議您注意以下幾點：設定合理的 Queue 處理時間限制、實作錯誤重試機制、監控 API 使用量與費用、以及考慮加入內容審核功能確保生成品質。 透過本方案建立的基礎架構，您可以進一步擴充至其他 AI 應用場景，如智慧搜尋、自動化客服、語言翻譯等功能。