11 available actions
What your AI agent can do in Luma Labs
Create and manage AI image and video generations and reusable files through the current Luma Agents API. This page lists every available action. Your agent only receives the actions and permissions required for the role you approve.
Showing all 11 actions.
Common starting points
- Get GenerationGet the current state, failure details, and output URLs for a Luma generation.
- Get FileGet a Luma file's metadata and current ingest, moderation, or deletion state.
- Generate ImageSubmit a paid, asynchronous Luma image generation job.
- Generate VideoSubmit a paid, asynchronous Ray 3.2 video generation job.
- Edit ImageSubmit a paid, asynchronous Luma image-edit job.
- Edit VideoSubmit a paid, asynchronous Ray 3.2 video-edit job.
Browse all 11 actions by capability
Open a capability to see every supported action and its description.
Find & reviewLook up and review existing recordsView 3 actions
- Get FileGet a Luma file's metadata and current ingest, moderation, or deletion state.
- Get GenerationGet the current state, failure details, and output URLs for a Luma generation.
- List FilesList files in the connected Luma account, newest first, with optional state and purpose filters.
Create & communicateCreate records or send supported messagesView 3 actions
- Generate ImageSubmit a paid, asynchronous Luma image generation job.
- Generate VideoSubmit a paid, asynchronous Ray 3.2 video generation job.
- Upload FileDirectly upload file bytes to Luma and return the file ID, metadata, and current upload/ingest state.
Update & manageChange and manage existing recordsView 2 actions
- Edit ImageSubmit a paid, asynchronous Luma image-edit job.
- Edit VideoSubmit a paid, asynchronous Ray 3.2 video-edit job.
Remove & cancelRemove records or cancel supported workView 1 action
- Delete FileSoft-delete a Luma file so new generations cannot reference it.
Other actionsSpecialist and administrative actions.View 2 actions
- Extract Image LayersSubmit a paid, asynchronous Luma image layer-extraction job.
- Reframe VideoSubmit a paid, asynchronous Ray 3.2 video-reframe job.
Connection record
A connection you can control.
- Sign-in
- Customer-managed key
- Setup
- Use a key you create and control. It is stored securely and limited to the work agreed for the role.
- Boundaries
- Only the approved role and actions.
- Off switch
- Revoke the connection from your account.
FAQ
Before you connect Luma Labs
How does the agent connect to Luma Labs?
With a key you create and control. It is stored securely, permissions are limited to what the agent needs, and you can revoke it at any time.
What can the agent actually do in Luma Labs?
The page above lists the 11 actions currently available through the Luma Labs connection. The role determines which of those actions the agent may use, and write access is only enabled when the workflow needs it.
Is Luma Labs included in my plan?
Connections are priced per tool on top of the base plan. Some are included and some are premium. See pricing for how connection charges work.
How long until Luma Labs is ready?
Timing depends on the sign-in method, permissions and workflow being connected. We confirm the scope and setup plan before enabling the connection.
Bring the workflow together
Ready to put Luma Labs to work?
Start with the responsibility you want off your plate. We’ll map the connection and the boundaries around it.