6 min read

Laravel OpenAI Package: What You Need To Know

Interested in generating passive income? Join our partnership program and receive a commission on each new client referral. Learn more.

Laravel Openai

The Laravel OpenAI package is an innovative tool in Laravel development that smoothly integrates with the OpenAI API. It acts as a wrapper for the openai-php/client, designed specifically for the Laravel community.

The OpenAI Laravel package owes its existence to the collaborative efforts of two dedicated developers, Nuno Maduro and Sandro Gehri. Their knowledge and dedication have resulted in a tool that greatly simplifies how PHP developers, especially those in the Laravel ecosystem, interact with the OpenAI API.

In this article, we’ll delve deeper into the setup and practical applications of this package and will also highlight its underlying functionalities and usage within the Laravel framework.

Understanding Laravel OpenAI Package

At its core, the Laravel OpenAI package is a PHP API client that makes connecting and interacting with the OpenAI API much easier. Its primary goal is to provide an intuitive and efficient way for Laravel developers to use the capabilities of OpenAI, including language models like GPT-3.5, in their applications.

Prerequisites and Installation

To get started with the OpenAI Laravel package (openai-php/laravel), you should meet certain prerequisites. First of all, make sure you have PHP version 8.1 or above. The installation process is straightforward, thanks to the Composer package manager. Simply run the following command:

composer require openai-php/laravel

After installation, the next step involves executing the install command:

php artisan openai:install

This command sets up a config/openai.php configuration file in your project. It also appends blank environment variables for the OpenAI API key and organization ID to your .env file, which you’ll need to fill in with your specific credentials.


Configuring the Laravel OpenAI package involves specifying your OpenAI API Key and organization in the .env file.


These credentials are crucial for authenticating with the OpenAI API.

You can also adjust the request timeout setting to suit your application’s needs. By default, the client times out after 30 seconds.

Usage: Bringing OpenAI into Laravel

The Laravel OpenAI package offers various functionalities that make the most of OpenAI’s language models. To illustrate it better, let’s delve into some practical examples:

Example: Generating Text with GPT-3.5

Imagine you want to generate a response to a user’s greeting using the GPT-3.5 model. Here’s how you can achieve this with the OpenAI Laravel facade:

use OpenAI\Laravel\Facades\OpenAI;
$result = OpenAI::chat()->create([
    'model' => 'gpt-3.5-turbo',
    'messages' => [
        ['role' => 'user', 'content' => 'Hello!'],
echo $result->choices[0]->message->content; // Outputs: Hello! How can I assist you today?

In this example, the create method is used to generate a chat completion. The response from the model is then accessed and printed.

Testing and Mock Responses

An essential aspect of development is testing. The OpenAI Laravel package offers a fake() method that allows you to mock API responses for testing purposes. For example:

use OpenAI\Laravel\Facades\OpenAI;
use OpenAI\Responses\Completions\CreateResponse;
        'choices' => [
            ['text' => 'awesome!'],
// Rest of your testing code

This approach is particularly useful when you need to test your application’s behavior with predetermined responses from the OpenAI API.

Advanced Usage and Customization

The openAI PHP package is for developers who are looking for advanced usage and customization. You can adjust requests, handle different types of resources, and analyze responses in detail. Whether you’re tweaking model settings, working with various resource types like audio or embeddings, or understanding detailed responses from the API, the package gives you a lot of flexibility and control.

OpenAI PHP for Plain PHP

As we’ve already mentioned, openAI PHP Laravel is a wrapper around the openai-php/client package. This underlying package provides the core functionalities for interacting with the OpenAI API and is designed to be framework-agnostic. Therefore, if you’re working with plain PHP or a different framework, openai-php/client is your go-to tool.


Laravel Openai

The OpenAI Laravel package is a community-driven project that makes integrating AI technologies into PHP applications simpler and provides developers with a range of possibilities to enhance their projects with intelligent features. So, with its ease of use and depth of functionality, this package will be a valuable addition to any developer.



Frequently Asked Questions

What is the OpenAI Laravel package?

The OpenAI Laravel package is a PHP API client for Laravel that facilitates interaction with the OpenAI API and makes it easier to integrate AI-powered features into Laravel applications.

How do I install the OpenAI Laravel package?

You can install the package using Composer with the command composer require openai-php/laravel, followed by php artisan openai:install to set up the necessary configuration.

Can I use the OpenAI PHP package with plain PHP?

Yes, the core functionalities of the OpenAI Laravel package are derived from the openai-php/client package, which is framework-agnostic and can be used with plain PHP.

What are the prerequisites for using this package?

The package requires PHP 8.1 or higher and Laravel’s support for the package version you intend to use.

Is it possible to test my application without making actual API calls?

Yes, the package offers a fake() method for mocking API responses, allowing you to test your application without making real API calls.

Meet the authors

We are a 200+ people agency and provide product design, software development, and creative growth marketing services to companies ranging from fresh startups to established enterprises. Our work has earned us 100+ international awards, partnerships with Laravel, Vue, Meta, and Google, and the title of Georgia’s agency of the year in 2019 and 2021.

Contact us