Luma AI Text-to-Video

Generate Videos from Text or Images

Overview

The Luma AI Dream Machine API allows developers to generate, retrieve, and extend AI-generated content using a variety of inputs. This API is particularly useful for creative applications, such as generating visual content from text prompts.

Authentication

All API requests require a Bearer token for authentication. Include your token in the Authorization header of each request.

Pricing

Each generation costs 500 000 AI/ML Tokens

API Reference

Ensure you replace "your-api-key" with your actual API key before running the code.

post

/luma-ai/generations

Authorizations

Body

expand_promptboolean · default: false

Whether to expand the prompt

Example: true

image_end_urlstring · uri

The URL for the end of the image

Example: https://example.com/image-end.jpg

image_urlstring · uri

The URL of the main image

Example: https://example.com/main-image.jpg

user_promptstringrequired

The user-provided prompt for image generation

Example: A beautiful sunset over the ocean

aspect_ratiostring · enumrequired

The aspect ratio of the image

Example: 16:9

Options: 1:1, 16:9, 9:16, 4:3, 3:4, 21:9, 9:21

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.aimlapi.com/luma-ai/generations' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "expand_prompt": true,
    "image_end_url": "https://example.com/image-end.jpg",
    "image_url": "https://example.com/main-image.jpg",
    "user_prompt": "A beautiful sunset over the ocean",
    "aspect_ratio": "16:9"
  }'

201

201

No body

Example

Python

import requests

url = "https://api.aimlapi.com/luma-ai/generations"

payload = {
  "aspect_ratio": "16:9",
  "expand_prompt": True,
  "user_prompt": "Flying jellyfish"
}
headers = {
  "Authorization": "Bearer your-api-key",
  "content-type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

JS

const axios = require('axios');

const url = "https://api.aimlapi.com/luma-ai/generations";

const payload = {
  aspect_ratio: "16:9",
  expand_prompt: true,
  user_prompt: "Flying jellyfish"
};

const headers = {
  "Authorization": "Bearer your-api-key",
  "content-type": "application/json"
};

axios.post(url, payload, { headers })
  .then(response => console.log(response.data))
  .catch(error => console.error(error));

get

/luma-ai/generation

Authorizations

Query parameters

LumaAi.v1.FetchGenerationsByIdsPayloadobjectrequired

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.aimlapi.com/luma-ai/generation?LumaAi.v1.FetchGenerationsByIdsPayload=%5Bobject+Object%5D' \
  --header 'Authorization: Bearer JWT'

200

200

No body

Example

Python

import requests

url = "https://api.aimlapi.com/luma-ai/generation"

querystring = {"ids[0]":"4c9126f3-d9a6-4eaf-aa4c-b64b634f65bd"}

headers = {
  "Authorization": "Bearer your-api-key",
  "content-type": "application/json"
}

response = requests.get(url, headers=headers, params=querystring)

print(response.json())

JS

const axios = require('axios');

const url = "https://api.aimlapi.com/luma-ai/generation";

const params = {
  "ids[0]": "4c9126f3-d9a6-4eaf-aa4c-b64b634f65bd"
};

const headers = {
  "Authorization": "Bearer your-api-key",
  "content-type": "application/json"
};

axios.get(url, { headers, params })
  .then(response => console.log(response.data))
  .catch(error => console.error(error));

post

/luma-ai/generations/{taskId}/extend

Authorizations

Path parameters

taskIdstringrequired

Body

all of

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.aimlapi.com/luma-ai/generations/{taskId}/extend' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "expand_prompt": true,
    "image_end_url": "https://example.com/image-end.jpg",
    "image_url": "https://example.com/main-image.jpg",
    "user_prompt": "A beautiful sunset over the ocean",
    "aspect_ratio": "16:9"
  }'

201

201

No body

Example

Python

import requests

url = "https://api.aimlapi.com/luma-ai/generations/57a6cb80-6da0-49bd-b29a-3f089b9e55e4/extend"

payload = {
  "aspect_ratio": "16:9",
  "expand_prompt": True,
  "user_prompt": "Flying jellyfish with a hat"
}
headers = {
  "Authorization": "Bearer your-api-key",
  "content-type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

JS

const axios = require('axios');

const url = "https://api.aimlapi.com/luma-ai/generations/57a6cb80-6da0-49bd-b29a-3f089b9e55e4/extend";

const payload = {
  aspect_ratio: "16:9",
  expand_prompt: true,
  user_prompt: "Flying jellyfish with a hat"
};

const headers = {
  "Authorization": "Bearer your-api-key",
  "content-type": "application/json"
};

axios.post(url, payload, { headers })
  .then(response => console.log(response.data))
  .catch(error => console.error(error));