luma generate - API Doc-CometAPI

Request

Header Params

Authorization

string

required

Example:

Bearer {{api-key}}

Content-Type

string

optional

Example:

application/json;charset=utf-8

Body Params application/json

prompt

string

required

prompt

loop

boolean

optional

Whether to loop the video

aspect_ratio

string

optional

Aspect Ratio,Default:16:9

keyframes

object

optional

keyframe

frame0

object

optional

first frame

frame1

object

optional

last frame

callback_url

string

optional

Example

{
  "prompt": "A tiger walking in snow",
  "keyframes": {
    "frame0": {
      "type": "image",
      "url": "https://storage.cdn-luma.com/dream_machine/7e4fe07f-1dfd-4921-bc97-4bcf5adea39a/video_0_thumb.jpg"
    }
  }
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.cometapi.com/dream-machine/v1/generations' \
--header 'Authorization: Bearer {{api-key}}' \
--header 'Content-Type: application/json;charset=utf-8' \
--data-raw '{
  "prompt": "A tiger walking in snow",
  "keyframes": {
    "frame0": {
      "type": "image",
      "url": "https://storage.cdn-luma.com/dream_machine/7e4fe07f-1dfd-4921-bc97-4bcf5adea39a/video_0_thumb.jpg"
    }
  }
}'

Responses

🟢201Created

application/json

Body

id

string

required

Unique identifier for the task or resource

state

string

required

Current task status

created_at

string

required

Task creation timestamp

request

object

required

Original user request parameters

prompt

string

required

Text prompt or description input by the user

aspect_ratio

string

required

Expected output aspect ratio

enhance

boolean

required

Whether to enable enhancement or high-definition processing, true means enabled

request_type

string

required

Request type, "keyframe" may indicate animation or video generation based on key frames

media_request

object

required

Specific request parameters related to media processing

end

null

required

End frame or end media object, null indicates unspecified or not applicable

loop

boolean

required

Whether to loop playback, false means no looping

prompt_type

string

required

Prompt type, similar to request.request_type, confirms processing method

rich_text

null

required

Rich text format prompt, null indicates not used

start

object

required

Starting frame or starting media object information

text

string

required

Actual text prompt used for processing, may be the same as request.prompt or processed

artifact

object

required

Information related to the final product or result generated

created_at

string

required

Artifact creation timestamp, the default zero value here indicates not yet created or information not filled

Example

{
    "id": "fe6cd271-eec5-46dd-a753-b97c4d576616",
    "state": "pending",
    "created_at": "2025-03-09T05:09:24.137448Z",
    "request": {
        "prompt": "A tiger walking in snow",
        "aspect_ratio": "16:9",
        "enhance": true,
        "request_type": "image_to_video"
    },
    "media_request": {
        "end": null,
        "loop": false,
        "prompt_type": "keyframe",
        "start": {
            "id": "fd4643c2-27d1-4482-82fa-092c1f1f2839",
            "media_type": null,
            "thumbnail": null,
            "type": "upload"
        },
        "text": "A tiger walking in snow"
    }
}