Skip to content
Getting started

API

Call Luma's image and video models directly: one request per generation, submit, poll, download.

The Luma API gives you direct access to Luma’s image and video models: uni-1 and uni-1-max for images, and Ray 3.2 for video. Generate from a prompt or from reference images and keyframes, edit or restyle an existing image or clip, extend a shot, reframe a video to a new aspect ratio, or split an image into layers. Every job runs on the same async REST endpoint: you submit it, poll it, and download the output.

  1. 1SubmitPOST /v1/generationsSend the prompt and options
  2. 2PollGET /v1/generations/{id}Repeat until the state is completed or failed
  3. 3Downloadoutput[].urlA presigned link per output, valid for one hour
ImagesVideo
Make newFrom a prompt or reference imagesFrom a prompt, start and end frames, or keyframes
Change existingEdit or restyleEdit, extend, reframe
Split into layersLayering

You can also upload a file once and reuse it across many generations, and delete a generation and its outputs when you no longer need them.