PHPackages                             aisdk/luma - 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. aisdk/luma

ActiveLibrary

aisdk/luma
==========

Official Luma provider for the PHP AI SDK.

v0.8.3(yesterday)05↑2900%MITPHP ^8.3

Since Jul 22Compare

[ Source](https://github.com/phpaisdk/luma)[ Packagist](https://packagist.org/packages/aisdk/luma)[ Fund](https://opencollective.com/phpaisdk)[ RSS](/packages/aisdk-luma/feed)WikiDiscussions Synced today

READMEChangelog (4)Dependencies (5)Versions (5)Used By (0)

aisdk/luma
==========

[](#aisdkluma)

[![GitHub Workflow Status](https://camo.githubusercontent.com/5f2863e48407fca5d007725af4ce95f877752f4f232e3246a85da84899bcbb45/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f706870616973646b2f6c756d612f74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d5465737473)](https://github.com/phpaisdk/luma/actions)[![Latest Version](https://camo.githubusercontent.com/6abc377bf3a8a69df17af06b93b1577cb17bd35c0805485adcc451af98a87d29/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f616973646b2f6c756d61)](https://packagist.org/packages/aisdk/luma)[![License](https://camo.githubusercontent.com/3c6adc985f24437cc445a6425e24669ebd0f7b50193926c48bbdabd2b3e18a84/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f616973646b2f6c756d61)](https://packagist.org/packages/aisdk/luma)

---

Official Luma provider for the PHP AI SDK. Uses Luma Dream Machine's native video-generation API.

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

[](#installation)

```
composer require aisdk/luma
```

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

[](#basic-usage)

```
use AiSdk\Generate;
use AiSdk\Luma;

Luma::create(['apiKey' => $_ENV['LUMA_API_KEY']]);

$video = Generate::video('A cinematic product reveal')
    ->model(Luma::model('ray-2'))
    ->aspectRatio('16:9')
    ->duration(5)
    ->run(timeout: 600);
```

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

[](#configuration)

VariableDescriptionDefault`LUMA_API_KEY`API key for authenticationRequired`LUMA_BASE_URL`Base URL for API requests`https://api.lumalabs.ai/dream-machine/v1`Supported Capabilities
----------------------

[](#supported-capabilities)

CapabilitySupportText-to-video generationNativeAsync job pollingNativeImage-to-video and other Dream Machine fieldsVia raw provider optionsThe package creates a `/generations/video` job and polls `/generations/{id}` until the video is available. Use `providerOptions('luma', ['keyframes' => [...], 'resolution' => '720p'])` for supported native Luma request fields.

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

[](#documentation)

- [Luma Dream Machine video-generation documentation](https://docs.lumalabs.ai/ue/docs/video-generation)
- [PHP AI SDK documentation](https://phpaisdk.com/docs/luma)

###  Health Score

39

—

LowBetter than 84% of packages

Maintenance100

Actively maintained with recent releases

Popularity5

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

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

Every ~0 days

Total

4

Last Release

1d ago

### Community

Maintainers

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

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

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

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

PHPackages © 2026

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