Custom Providers

Want to add support for a new AI provider in Prism? This guide will walk you through creating and registering your own custom provider implementation.

Provider Interface

All providers must implement the EchoLabs\Prism\Contracts\Provider interface:

namespace EchoLabs\Prism\Contracts;

interface Provider
{
    public function text(TextRequest $request): ProviderResponse;
}

The interface is intentionally simple, requiring just one method to handle text generation requests.

Registration Process

Once you've created your provider, register it with Prism in a service provider:

namespace App\Providers;

use App\Prism\Providers\MyCustomProvider;
use Illuminate\Support\ServiceProvider;

class AppServiceProvider extends ServiceProvider
{
    public function boot(): void
    {
        $this->app['prism-manager']->extend('my-custom-provider', function ($app, $config) {
            return new MyCustomProvider(
                apiKey: $config['api_key'] ?? '',
            );
        });
    }
}

Then add your provider configuration to config/prism.php:

return [
    'providers' => [
        // ... other providers ...
        'my-custom-provider' => [
            'api_key' => env('MY_CUSTOM_PROVIDER_API_KEY'),
        ],
    ],
];

Now you can use your custom provider:

use EchoLabs\Prism\Facades\Prism;

$response = Prism::text()
    ->using('my-custom-provider', 'model-name')
    ->withPrompt('Hello, custom AI!')
    ->generate();