Luma 1 (Text-to-Video) [legacy]

Description for Luma AI Text-to-Video model: Pricing, API Reference, Examples.

Here is our backward-compatible support for the older Luma AI API.

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.

Each generation costs 500 000 AI/ML Tokens.

Setup your API Key

If you don’t have an API key for the AI/ML API yet, feel free to use our Quickstart guide.

How to Make a Call

Step-by-Step Instructions

Generating a video using this model involves making two sequential API calls:

The first one is for creating and sending a video generation task to the server (returns a generation ID). This can be either a generation from a reference image/prompt or a video extension operation that adds length to an existing video.
The second one is for requesting the generated or extended video from the server using the generation ID received from the first endpoint.

Below, you can find three corresponding API schemas and examples for all endpoint calls.

API Schemas

Ensure you replace <YOUR_AIMLAPI_KEY> with your actual API key before running the code.

Generate Video

post

Authorizations

AuthorizationstringRequired

Bearer key

Body

modelstring · enumOptionalDefault: ray-1-6Possible values:

aspect_ratiostring · enumRequired

The aspect ratio of the image

Example: 16:9Possible values:

expand_promptbooleanOptional

Whether to expand the prompt

Default: falseExample: true

image_end_urlstring · uriOptional

The URL for the end of the image

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

image_urlstring · uriOptional

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

Responses

201Success

post

/luma-ai/generations

POST /luma-ai/generations HTTP/1.1
Host: api.aimlapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 213

{
  "model": "ray-1-6",
  "aspect_ratio": "16:9",
  "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"
}

201Success

No content

Example

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_AIMLAPI_KEY>",
  "content-type": "application/json"
}

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

print(response.json())

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_AIMLAPI_KEY>",
  "content-type": "application/json"
};

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

Fetch Generations

get

Authorizations

AuthorizationstringRequired

Bearer key

Query parameters

idsany ofRequired

Array of UUID strings or string with comma-separated UUID strings

string · uuid[] · min: 1Optional

stringOptional

Responses

200Success

No content

get

/luma-ai/generation

GET /luma-ai/generation?ids=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: api.aimlapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200Success

No content

Example

import requests

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

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

headers = {
  "Authorization": "Bearer <YOUR_AIMLAPI_KEY>",
  "content-type": "application/json"
}

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

print(response.json())

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_AIMLAPI_KEY>",
  "content-type": "application/json"
};

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

Extend Video

Extend allows you to effortlessly add length to an existing video.

post

Authorizations

AuthorizationstringRequired

Bearer key

Path parameters

taskIdstringRequired

Body

Responses

201Success

post

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

POST /v1/luma-ai/generations/{taskId}/extend HTTP/1.1
Host: api.aimlapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 213

{
  "model": "ray-1-6",
  "aspect_ratio": "16:9",
  "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"
}

201Success

No content

Example

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_AIMLAPI_KEY>",
  "content-type": "application/json"
}

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

print(response.json())

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_AIMLAPI_KEY>",
  "content-type": "application/json"
};

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

PreviousLuma AI NextLuma Ray 1.6 (Text-to-Video)

Last updated 5 months ago

Was this helpful?