PHPackages                             aisdk/fal - 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. [Image & Media](/categories/media)
4. /
5. aisdk/fal

ActiveLibrary[Image & Media](/categories/media)

aisdk/fal
=========

Official fal provider for the PHP AI SDK.

v0.8.0(1mo ago)01MITPHPPHP ^8.3CI passing

Since Jul 15Pushed 1mo agoCompare

[ Source](https://github.com/phpaisdk/fal)[ Packagist](https://packagist.org/packages/aisdk/fal)[ Docs](https://github.com/phpaisdk/fal)[ RSS](/packages/aisdk-fal/feed)WikiDiscussions main Synced 1w ago

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

aisdk/fal
=========

[](#aisdkfal)

[![GitHub Workflow Status](https://camo.githubusercontent.com/570848ada860fa63f4be83b8a747deae603d8cf01ee34944f9d0300ecc2dad78/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f706870616973646b2f66616c2f74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d5465737473)](https://github.com/phpaisdk/fal/actions)[![Total Downloads](https://camo.githubusercontent.com/4d95bd3000aaa27d975e6a39258814f84ff134809efb667e586d6953ec782d4c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f616973646b2f66616c)](https://packagist.org/packages/aisdk/fal)[![Latest Version](https://camo.githubusercontent.com/89d349e32462860fc5c000ce224c4e08ff0c2987e4f2fc093a9393a18e24c47d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f616973646b2f66616c)](https://packagist.org/packages/aisdk/fal)[![License](https://camo.githubusercontent.com/70f018f8e5b96b770c2f45fd9ab4a919ffe25973b4b7aecc1a5ddce6940ea188/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f616973646b2f66616c)](https://packagist.org/packages/aisdk/fal)[![Why PHP in 2026](https://camo.githubusercontent.com/d2b9305e630caf7daae4ca023de39ece0b885c37461629d42961533f00868b76/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5768795f5048502d696e5f323032362d3741383645383f7374796c653d666c61742d737175617265266c6162656c436f6c6f723d313831383162)](https://whyphp.dev)

---

The fal provider package for the PHP AI SDK supports **image**, **speech**, **transcription**, and **video** generation via `fal.run` and `queue.fal.run`, aligned with `@ai-sdk/fal`.

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

[](#installation)

```
composer require aisdk/fal
```

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

[](#configuration)

VariablePurpose`FAL_API_KEY`Primary API key.`FAL_KEY`Fallback key name (matches upstream).`FAL_BASE_URL`Override default `https://fal.run`.Authorization header: `Authorization: Key `.

Usage
-----

[](#usage)

Model ids are fal route segments (for example `fal-ai/flux/schnell`).

```
use AiSdk\Generate;
use AiSdk\Fal;

$result = Generate::image()
    ->model(Fal::image('fal-ai/flux/schnell'))
    ->prompt('A minimal desk lamp.')
    ->run();
```

```
Generate::speech()
    ->model(Fal::speech('fal-ai/minimax/speech-02-hd'))
    ->input('Hello')
    ->run();
```

Video generation submits to `queue.fal.run` and polls until a `video.url` is available (timeouts configurable via `videoPollIntervalMs` / `videoPollTimeoutMs`).

Language and embedding modalities are not implemented on fal in this package and throw `NoSuchModelException`.

Documentation
-------------

[](#documentation)

- [PHP AI SDK documentation](https://phpaisdk.com/docs)
- [fal documentation](https://phpaisdk.com/docs/fal)

Community
---------

[](#community)

- [Contributing](https://github.com/phpaisdk/.github/blob/main/CONTRIBUTING.md)
- [Support](https://github.com/phpaisdk/.github/blob/main/SUPPORT.md)
- For private security reports, email .

License
-------

[](#license)

MIT.

###  Health Score

35

—

LowBetter than 77% of packages

Maintenance90

Actively maintained with recent releases

Popularity2

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

46d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ef29d1962da41e7526023f215cf844494e209b2fd163742084cb919a3b508021?d=identicon)[aisdk](/maintainers/aisdk)

---

Top Contributors

[![RanaMoizHaider](https://avatars.githubusercontent.com/u/58527494?v=4)](https://github.com/RanaMoizHaider "RanaMoizHaider (3 commits)")

---

Tags

imageaivideoTranscriptionspeechfalaisdk

###  Code Quality

TestsPest

Static AnalysisPHPStan, Rector

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/aisdk-fal/health.svg)

```
[![Health](https://phpackages.com/badges/aisdk-fal/health.svg)](https://phpackages.com/packages/aisdk-fal)
```

###  Alternatives

[media-alchemyst/media-alchemyst

An Object Oriented wrapper for easy multimedia conversion, based on Imagine, FFMpeg, SwfTools, Unoconv and other libs

68222.4k2](/packages/media-alchemyst-media-alchemyst)[nilportugues/sitemap-component

Standalone sitemap builder 100% standards compliant. Build for PHP5.3 and above.

5058.9k1](/packages/nilportugues-sitemap-component)[sonrisa/sitemap-component

Standalone sitemap builder 100% standards compliant. Build for PHP5.3 and above.

5017.6k](/packages/sonrisa-sitemap-component)[mediamonks/sonata-media-bundle

A powerful, flexible and easy to use alternative for the existing Sonata Media Bundle

109.9k](/packages/mediamonks-sonata-media-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)