aisdk/luma

Official Luma provider for the PHP AI SDK.

Maintainers

Package info

github.com/phpaisdk/luma

pkg:composer/aisdk/luma

Transparency log

Fund package maintenance!

Open Collective

Statistics

Installs: 5

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

v0.8.3 2026-07-22 06:44 UTC

This package is auto-updated.

Last update: 2026-07-22 06:45:05 UTC


README

GitHub Workflow Status Latest Version License

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

Installation

composer require aisdk/luma

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

Variable Description Default
LUMA_API_KEY API key for authentication Required
LUMA_BASE_URL Base URL for API requests https://api.lumalabs.ai/dream-machine/v1

Supported Capabilities

Capability Support
Text-to-video generation Native
Async job polling Native
Image-to-video and other Dream Machine fields Via raw provider options

The 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