API reference

Generate

POST

/luma/generations

Last modified:2025-02-05 11:30:30

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Content-Type

string

optional

Example:

application/json; charset=utf-8

Authorization

string

optional

Default:

Body Params application/json

user_prompt

string

required

aspect_ratio

string

required

expand_prompt

boolean

optional

是否开启prompt 优化

loop

boolean

required

循环一张参考图

image_url

string

optional

参考图，支持第三方图片地址、Base64

image_end_url

string

optional

关键帧，支持第三方图片地址、Base64

keyframes

object

optional

关键帧

frame0

object

首帧

optional

frame1

object

尾帧

optional

notify_hook

string

optional

回调地址： https://xxxxxxx

duration

string

optional

Examples:

5s10s

resolution

string

optional

Examples:

720p1080p

Example

{
  "user_prompt": "cat dance",
  "duration": "5s",
  "resolution": "1080p",
  "aspect_ratio": "16:9",
  "keyframes": {
    "frame0": {
      "type": "image",
      "url": "https://www.shutterstock.com/image-photo/beautifull-red-black-bengal-tiger-260nw-2526207017.jpg"
    }
  }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '/luma/generations' \
--header 'Authorization: ' \
--header 'Content-Type: application/json; charset=utf-8' \
--data-raw '{
    "user_prompt": "cat dance",
    "duration": "5s",
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "keyframes": {
        "frame0": {
            "type": "image",
            "url": "https://www.shutterstock.com/image-photo/beautifull-red-black-bengal-tiger-260nw-2526207017.jpg"
        }
    }
}'

Responses

🟢201成功

application/json

Body

created_at

string

required

estimate_wait_seconds

null

required

string

required

last_frame

null

required

liked

null

required

prompt

string

required

state

string

required

thumbnail

null

required

video

null

required

server_id

string

optional

Example

{
  "created_at": "2024-07-22T12:47:28.553735Z",
  "estimate_wait_seconds": null,
  "id": "fc7fb008-7a5e-40ad-a7ff-dbb63db61be8",
  "last_frame": null,
  "liked": null,
  "prompt": "cat dance",
  "state": "pending",
  "thumbnail": null,
  "video": null
}

Fetch task

Get video of no mark