Luma AI

App · 7 actions

Create images and videos with the Luma Agents API and track generation results.

Actions

ActionWhat it does
Create generationStart a billed image or video generation.
Delete fileDelete file.
Delete generationDelete generation.
Get deletionGet deletion.
Get fileGet file.
Get generationGet generation.
List filesList files.

Create generation

Start a billed image or video generation. Returns its job ID immediately; use Get generation or a completion trigger to retrieve the result.

Inputs

PromptprompttextRequired
Prompt.
Generation typegeneration_typetext
Generation type.One of: image, image_edit (Image edit), video, video_edit (Video edit), video_reframe (Video reframe), layering.
Modelmodeltext
Model.One of: uni-1, uni-1-max, ray-3.2.
Aspect ratioaspect_ratiotext
Aspect ratio.One of: 3:1, 2:1, 21:9, 16:9, 4:3, 3:2, 1:1, 3:4, 2:3, 9:16, 1:2, 1:3.
Output formatoutput_formattext
Output format.One of: png, jpeg.
Stylestyletext
Style.One of: auto, manga.
Image refimage_reflist
Image ref.
Sourcesourceobject
Source.
Videovideoobject
Video.
Web searchweb_searchtrue/false
Web search.
End user idend_user_idtext
End user id.

Outputs

dataobject
Service response.
Example output
{
  "data": {
    "created_at": "example",
    "failure_reason": "example",
    "id": "example",
    "model": "example",
    "output": [],
    "state": "example",
    "type": "example"
  }
}

Delete file

Delete file.

Inputs

File idfile_idtextRequired
File id.

Outputs

dataobject
Service response.
Example output
{
  "data": {}
}

Delete generation

Delete generation.

Inputs

Generation idgeneration_idtextRequired
Generation id.

Outputs

dataobject
Service response.
Example output
{
  "data": {}
}

Get deletion

Get deletion.

Inputs

Task idtask_idtextRequired
Task id.

Outputs

dataobject
Service response.
Example output
{
  "data": {}
}

Get file

Get file.

Inputs

File idfile_idtextRequired
File id.

Outputs

dataobject
Service response.
Example output
{
  "data": {
    "id": "example",
    "state": "example"
  }
}

Get generation

Get generation.

Inputs

Generation idgeneration_idtextRequired
Generation id.

Outputs

dataobject
Service response.
Example output
{
  "data": {
    "created_at": "example",
    "failure_reason": "example",
    "id": "example",
    "model": "example",
    "output": [],
    "state": "example",
    "type": "example"
  }
}

List files

List files.

Inputs

Cursorcursortext
Cursor.
Limitlimitnumber
Limit.From 1 to 100.

Outputs

dataobject
Service response.
Example output
{
  "data": {
    "data": [],
    "has_more": false,
    "next_cursor": "example"
  }
}

On this page