Skip to main content
Luma Labs logo
  • Category: media generation
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 11
  • Triggers: 0
  • Slug: LUMA_LABS
  • Version: 20261030_00
  • Instant: Supported on the latest version. Support varies by tool.

Tools

Slug: LUMA_LABS_DELETE_FILESoft-delete a Luma file so new generations cannot reference it. The file’s metadata remains retrievable with state=deleted.

Input Parameters

string
required
Luma file ID to soft-delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUMA_LABS_EDIT_IMAGESubmit a paid, asynchronous Luma image-edit job. Returns immediately; use GET_GENERATION with generation_id to monitor it.

Input Parameters

string ("uni-1" | "uni-1-max")
Image model. uni-1-max produces higher-quality output at a higher price.
string ("auto" | "manga")
Image style preset.
string
required
Instructions for editing the source image.
object
required
Image to edit.
string
Opaque, non-PII end-user identifier for usage and abuse attribution.
array
Additional reference images for style or content guidance; up to 8.
Allow web search for grounding and reference images.
string ("png" | "jpeg")
Requested image output format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUMA_LABS_EDIT_VIDEOSubmit a paid, asynchronous Ray 3.2 video-edit job. Returns immediately; use GET_GENERATION with generation_id to monitor it.

Input Parameters

object
Ray 3.2 video-edit options.
string
required
Instructions for editing the source video.
object
required
Video to edit; URL/data sources require video/* media_type.
string
Opaque, non-PII end-user identifier for usage and abuse attribution.
boolean
Allow web search for grounding and reference images.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUMA_LABS_EXTRACT_IMAGE_LAYERSSubmit a paid, asynchronous Luma image layer-extraction job. Pricing is flat per generation at the selected resolution, regardless of layer count; use GET_GENERATION with generation_id to monitor the job.

Input Parameters

string
required
Optional instructions for decomposing the source image into layers; pass an empty string for automatic decomposition.
object
required
Image to decompose into layers.
string
Opaque, non-PII end-user identifier for usage and abuse attribution.
object
Layer extraction output options.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUMA_LABS_GENERATE_IMAGESubmit a paid, asynchronous Luma image generation job. Returns immediately; use GET_GENERATION with generation_id to monitor it. Managed Instant calls must specify model explicitly. Maximum estimated Instant cost: $3.00 per call.Instant: Supported on the latest version.Instant pricing: $0.04 per image (uni-1) or $0.1 (uni-1-max); +$0.003 per reference image.

Input Parameters

string ("uni-1" | "uni-1-max")
Image model. uni-1-max produces higher-quality output at a higher price.
string ("auto" | "manga")
Image style preset.
string
required
Image generation instructions.
string
Opaque, non-PII end-user identifier for usage and abuse attribution.
array
Reference images for style or content guidance; up to 9.
boolean
Allow web search for grounding and reference images.
string ("3:1" | "2:1" | "16:9" | "3:2" | "1:1" | "2:3" | "9:16" | "1:2" | "1:3")
Requested output aspect ratio.
string ("png" | "jpeg")
Requested image output format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUMA_LABS_GENERATE_VIDEOSubmit a paid, asynchronous Ray 3.2 video generation job. Returns immediately; use GET_GENERATION with generation_id to monitor it. Managed Instant calls must specify video.resolution, video.duration, video.hdr, and video.exr_export. Maximum estimated Instant cost: $3.00 per call.Instant: Supported on the latest version.Instant pricing: From $0.06 per 5-second 360p video; varies with resolution and duration.

Input Parameters

object
Ray 3.2 video generation options.
string
required
Video generation instructions.
string
Opaque, non-PII end-user identifier for usage and abuse attribution.
boolean
Allow web search for grounding and reference images.
string ("9:16" | "3:4" | "1:1" | "4:3" | "16:9" | "21:9")
Requested output aspect ratio.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUMA_LABS_GET_FILEGet a Luma file’s metadata and current ingest, moderation, or deletion state. Soft-deleted files remain retrievable with state=deleted.

Input Parameters

string
required
Luma file ID returned by UPLOAD_FILE or LIST_FILES.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUMA_LABS_GET_GENERATIONGet the current state, failure details, and output URLs for a Luma generation.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Generation ID returned by a Luma image, video, edit, reframe, or layer-extraction tool.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUMA_LABS_LIST_FILESList files in the connected Luma account, newest first, with optional state and purpose filters. Returns one page and a cursor for continuation.

Input Parameters

integer
Maximum files to return in this page (1-100).
string ("pending" | "ready" | "failed" | "deleted")
Return only files in this ingest or deletion state.
string
Opaque next_cursor from a previous LIST_FILES response.
string ("input" | "reference")
Return only files with this purpose.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUMA_LABS_REFRAME_VIDEOSubmit a paid, asynchronous Ray 3.2 video-reframe job. Returns immediately; use GET_GENERATION with generation_id to monitor it.

Input Parameters

object
Ray 3.2 video-reframe options.
string
required
Instructions for reframing the source video.
object
required
Video to reframe; URL/data sources require video/* media_type.
string
Opaque, non-PII end-user identifier for usage and abuse attribution.
boolean
Allow web search for grounding and reference images.
string ("9:16" | "3:4" | "1:1" | "4:3" | "16:9" | "21:9")
required
Required output aspect ratio.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUMA_LABS_UPLOAD_FILEDirectly upload file bytes to Luma and return the file ID, metadata, and current upload/ingest state.

Input Parameters

object
required
File whose bytes will be uploaded to Luma.
string ("input" | "reference")
How the file will be used: input for primary source material or reference for style and content guidance.
string
Optional opaque, non-PII end-user identifier for abuse attribution.
string
Optional ISO 8601 time after which Luma may delete the file.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not