MaxAPI Docs

Luma Task Creation

Developing

Main URLs

POST

/luma/generations

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/json

user_prompt

string

required

prompt content

Example:

cat dance

aspect_ratio

string

optional

aspect ratio

Example:

16:9

expand_prompt

string

optional

prompt optimization

Example:

true

image_url

string

optional

reference image, supports third-party image addresses, base64

image_end_url

string

optional

keyframes, supporting third-party image addresses and base64

notify_hook

string

optional

callback address: https://xxxxxxx

Example

{
  "user_prompt": "cat dance",
  "aspect_ratio": "16:9",
  "expand_prompt": "true",
  "image_url": "http://dummyimage.com/400x400",
  "image_end_url": "http://dummyimage.com/400x400",
  "notify_hook": "enim"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.maxapi.ai/luma/generations' \
--header 'Content-Type: application/json' \
--data-raw '{
    "user_prompt": "cat dance",
    "aspect_ratio": "16:9",
    "expand_prompt": "true",
    "image_url": "http://dummyimage.com/400x400",
    "image_end_url": "http://dummyimage.com/400x400",
    "notify_hook": "enim"
}'

Responses

🟢201Created

application/json

Body

object {0}

Example

{
  "id": "9d4b7516-77e5-481a-b015-48313946f33b",
  "prompt": "cat dance",
  "state": "pending",
  "created_at": "2024-07-19T07:35:13.498660Z",
  "video": null,
  "liked": null,
  "estimate_wait_seconds": null
}

Modified at 2024-07-19 16:11:24

Obtain the seed of the Task Image

Luma Expand Video