Luma API v1

April 6, 2026

This is the experimental API for Luma Dream Machine by Luma AI.

Luma Dream Machine creates AI-generated videos and images using Luma’s proprietary models.

Parameter Video (POST /videos) Image (POST /images)
Models ray-v3-flash (default), ray-v3, ray-v3-reasoning photon-v2 (default), image-v2
Aspect ratios 9:16, 3:4, 1:1, 4:3, 16:9 (default), 21:9 same
Resolutions draft (default), 540p, 720p, 1080p 720p (default), 1080p
Durations 5s (default), 10s
Dynamic ranges sdr (default), hdr, hdr_exr
Keyframes imageStart, imageEnd via POST /assets
Character ref imageCharacter (ray-v3 + sdr only)
Image refs imageRef1..4 (up to 4, image-v2 locked to 720p)

Cost estimate (Luma Unlimited subscription):

  • Unlimited plan ($99.99/mo): unlimited generations at all resolutions and durations.

⚙️ Setup Luma

📦 Postman collection (April 6, 2026)

🤖 LLM-friendly API spec Feed this to your LLM to build integrations

Developer Community:


Table of contents