PHPackages                             hosmelq/falai - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. hosmelq/falai

ActiveLibrary[API Development](/categories/api)

hosmelq/falai
=============

The fal.ai client for PHP.

v0.1.0(11mo ago)51.7k↓90.6%1MITPHPPHP ^8.2CI passing

Since Jul 20Pushed 11mo agoCompare

[ Source](https://github.com/hosmelq/falai-php)[ Packagist](https://packagist.org/packages/hosmelq/falai)[ RSS](/packages/hosmelq-falai/feed)WikiDiscussions main Synced yesterday

READMEChangelog (1)Dependencies (18)Versions (2)Used By (0)

falai-php
=========

[](#falai-php)

The [fal.ai](https://fal.ai) client for PHP.

Built on the [Saloon PHP](https://docs.saloon.dev) library with [sse-saloon](https://github.com/hosmelq/sse-saloon) for Server-Sent Events support.

Features
--------

[](#features)

- **Queue-based processing** - Submit requests to fal.ai's queue system for asynchronous processing.
- **Synchronous execution** - Direct model execution without queueing.
- **Status streaming** - Stream status updates using Server-Sent Events.
- **Request cancellation** - Cancel queued requests when needed.

Requirements
------------

[](#requirements)

- PHP 8.2+
- `ext-sodium` (optional, required for webhook verification).
- PSR-16 cache implementation (optional, for improved webhook verification performance).

Installation
------------

[](#installation)

```
composer require hosmelq/falai
```

Configuration
-------------

[](#configuration)

Set your fal.ai API key as an environment variable:

```
FAL_KEY='your-api-key-here'
```

Or pass it directly to the client:

```
$fal = FalAI::client('your-api-key-here');
```

Basic Usage
-----------

[](#basic-usage)

**Queue-based execution (recommended):**

```