Luma

Modes: video, image · Models: 9

Vendor: Luma AI · Official API docs: Luma Dream Machine API

Luma's Dream Machine line covers both video and image. Ray 3.2 (with Ray 2 and the faster Flash 2) generates video from text or a start/end frame at up to 4K, with dedicated edit and reframe workflows for changing a clip's aspect ratio. UNI-1 (and UNI-1 Max) is the image model, with multi-image reference input, edit, and style controls.

Models

id	Name	Input type
luma-ray-2	Luma Ray 2	t2v
luma-ray-flash-2	Luma Flash 2	i2v
luma-ray-2-reframe-video	Luma Ray 2 Reframe	v2v
luma-ray-flash-2-reframe-video	Luma Flash 2 Reframe	v2v
luma-uni-1	Luma UNI-1	t2i
luma-uni-1-max	Luma UNI-1 Max	t2i
luma-ray-3.2	Luma Ray 3.2	t2v
luma-ray-3.2-edit	Luma Ray 3.2 Edit	v2v
luma-ray-3.2-reframe-video	Luma Ray 3.2 Reframe	v2v

CLI

# text-to-video at 4K
gen-ai generate -m luma-ray-2 \
  -p "a paper boat drifting down a rain-soaked city gutter, cinematic" \
  --ar 16:9 -r 4k -d 9

# image-to-video from a start frame
gen-ai generate -m luma-ray-2 -p "slow zoom out, drifting clouds" --start-frame ./hero.jpg

# reframe an existing clip to vertical
gen-ai generate -m luma-ray-2-reframe-video --video ./clip.mp4 --ar 9:16

# text-to-image with a reference
gen-ai generate -m luma-uni-1 -p "a fox in a moss-green raincoat, storybook" --ar 1:1 -i ./ref.jpg

MCP

{ "name": "picsart_generate",
  "arguments": {
    "model": "luma-ray-2",
    "prompt": "a paper boat drifting down a rain-soaked city gutter, cinematic",
    "aspectRatio": "16:9",
    "resolution": "4k",
    "duration": 9
  } }

{ "name": "picsart_generate",
  "arguments": {
    "model": "luma-uni-1",
    "prompt": "a fox in a moss-green raincoat, storybook",
    "aspectRatio": "1:1",
    "style": "auto"
  } }

Parameters

Full parameter surface for every model, sourced from gen-ai models info <id> --json. CLI flags show the primary short form; the canonical --kebab-case long form always works too.

luma-ray-2 — Luma Ray 2

Try luma-ray-2 in Playground ↗

Input type: t2v

Param	CLI flag	Type	Values
prompt	-p	text	required
aspectRatio	--ar	enum	16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 · 9:21 (default 16:9)
resolution	-r	enum	540p · 720p · 1080p · 4k (default 720p)
duration	-d	enum	5 · 9 (default 5)
startFrame	--start-frame	file	image
endFrame	--end-frame	file	image

luma-ray-flash-2 — Luma Flash 2

Try luma-ray-flash-2 in Playground ↗

Input type: i2v

Param	CLI flag	Type	Values
prompt	-p	text	required
aspectRatio	--ar	enum	16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 · 9:21 (default 16:9)
resolution	-r	enum	540p · 720p · 1080p · 4k (default 720p)
duration	-d	enum	5 · 9 (default 5)
startFrame	--start-frame	file	required image
endFrame	--end-frame	file	image

luma-ray-2-reframe-video — Luma Ray 2 Reframe

Try luma-ray-2-reframe-video in Playground ↗

Input type: v2v

Param	CLI flag	Type	Values
prompt	-p	text	free text
aspectRatio	--ar	enum	16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 · 9:21 (default 16:9)
videoUrl	--video	file	required video

luma-ray-flash-2-reframe-video — Luma Flash 2 Reframe

Try luma-ray-flash-2-reframe-video in Playground ↗

Input type: v2v

Param	CLI flag	Type	Values
prompt	-p	text	free text
aspectRatio	--ar	enum	16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 · 9:21 (default 16:9)
videoUrl	--video	file	required video

luma-uni-1 — Luma UNI-1

Try luma-uni-1 in Playground ↗

Input type: t2i

Param	CLI flag	Type	Values
prompt	-p	text	required (≤6000 chars)
aspectRatio	--ar	enum	3:1 · 2:1 · 16:9 · 3:2 · 1:1 · 2:3 · 9:16 · 1:2 · 1:3 (default 1:1)
style	--style	enum	auto (Auto) · manga (Manga) (default auto)
imageUrls	-i	file	image (up to 9)

luma-uni-1-max — Luma UNI-1 Max

Try luma-uni-1-max in Playground ↗

Input type: t2i

Param	CLI flag	Type	Values
prompt	-p	text	required (≤6000 chars)
aspectRatio	--ar	enum	3:1 · 2:1 · 16:9 · 3:2 · 1:1 · 2:3 · 9:16 · 1:2 · 1:3 (default 1:1)
style	--style	enum	auto (Auto) · manga (Manga) (default auto)
imageUrls	-i	file	image (up to 9)

luma-ray-3.2 — Luma Ray 3.2

Try luma-ray-3.2 in Playground ↗

Input type: t2v

Param	CLI flag	Type	Values
prompt	-p	text	required (≤6000 chars)
aspectRatio	--ar	enum	9:16 · 3:4 · 1:1 · 4:3 · 16:9 · 21:9 (default 16:9)
resolution	-r	enum	540p · 720p · 1080p (default 720p)
duration	-d	enum	5 · 10 (default 5)
startFrame	--start-frame	file	image
endFrame	--end-frame	file	image
hdr	--hdr	boolean	true · false (default false)
exrExport	--exr-export	boolean	true · false (default false)
loop	--loop	boolean	true · false (default false)

luma-ray-3.2-edit — Luma Ray 3.2 Edit

Try luma-ray-3.2-edit in Playground ↗

Input type: v2v

Param	CLI flag	Type	Values
prompt	-p	text	required (≤6000 chars)
videoUrl	--video	file	required video
resolution	-r	enum	540p · 720p · 1080p (default 720p)
duration	-d	enum	5 · 10 (default 5)
editStrength	--edit-strength	enum	adhere_1 (Adhere 1) · adhere_2 (Adhere 2) · adhere_3 (Adhere 3) · flex_1 (Flex 1) · flex_2 (Flex 2) · flex_3 (Flex 3) · reimagine_1 (Reimagine 1) · reimagine_2 (Reimagine 2) · reimagine_3 (Reimagine 3) (default flex_2)
hdr	--hdr	boolean	true · false (default false)
exrExport	--exr-export	boolean	true · false (default false)

luma-ray-3.2-reframe-video — Luma Ray 3.2 Reframe

Try luma-ray-3.2-reframe-video in Playground ↗

Input type: v2v

Param	CLI flag	Type	Values
prompt	-p	text	required (≤6000 chars)
aspectRatio	--ar	enum	9:16 · 3:4 · 1:1 · 4:3 · 16:9 · 21:9 (default 16:9)
videoUrl	--video	file	required video
resolution	-r	enum	540p · 720p · 1080p (default 720p)

Notes: The reframe variants take a required videoUrl (--video) plus --ar.

Pricing

gen-ai pricing luma-ray-2 -d 9 -r 4k

Video cost scales with duration and resolution. UNI-1 image cost is per generation.