AI Video API

Luma API:
AI Video Generation

Build cinematic AI video on Luma's Ray 3 Dream Machine models through one unified API. A single REST endpoint, async jobs, and webhooks deliver smooth motion, with no separate account to manage.

Integrate Luma API View Documentation

Trusted by growing companies worldwide

Does Luma AI Offer a Dream Machine API?

Yes, Luma AI has an official API.

However, wiring up that integration directly can get complex. Apiframe wraps the Dream Machine API in a production-ready layer with webhook events, multiple SDKs, and unified billing across other AI models. You manage a single api key instead of juggling separate accounts.

Note: Either way, Apiframe gives you simple REST endpoints that turn text and an image url into finished videos, and handles the heavy lifting end to end.

Disclaimer: Apiframe is not affiliated with, endorsed by, or sponsored by Luma AI. Luma is a trademark of Luma Labs, Inc.

Everything You Need in a Luma AI API

Production-ready features for developers building with Luma AI.

Dream Machine Text to Video

Turn a text prompt into cinematic video generation on the Ray 3 family. Ray 3.14 renders physically accurate scenes with smooth motion at native 1080p by default.

Image to Video

Animate a static image url into dynamic footage. Ray 3.14 brings any image to life up to 4x faster than base Ray 3, and you can preview a draft before the full render.

Ray 3 Modify (Video to Video)

Restyle and modify existing footage with Ray 3 Modify, guided by keyframe and character-reference controls so actors and scenes stay consistent across shots.

Keyframe Control

Define start and end frames to shape the narrative flow. A clear default makes it easy to check transitions when building storytelling sequences.

Extend & Loop

Extend a clip to a longer duration and loop it seamlessly. The max length suits social media content and ambient visuals.

Camera Control

Direct the camera with simple text instructions: pan, zoom, and dolly moves that find the cinematic angle you want.

Variable Aspect Ratios

Render video in any aspect ratio: 16:9, 9:16, 1:1, and more, so every platform is covered without complex editing.

Webhook Support

Receive webhook events the moment a render finishes, with a clear status for every job so no polling is required for async workflows.

Multiple SDKs

Call the API from Node.js, Python, PHP, and Go, or wire up no-code integrations. Official SDKs make building an integration quick.

Quick Start – Get Running in 5 Minutes

Generate your first Luma AI video with just a few lines of code.

example.js

const { Apiframe } = require('@apiframe-ai/sdk');

// Initialize the client
const client = new Apiframe({
  apiKey: 'your_api_key_here'
});

async function generateVideo() {
  // Submit a Luma Ray video-generation job
  const job = await client.videos.generate({
    model: 'luma-ray-2',
    prompt: 'cinematic shot of a sunset over mountains, golden hour lighting, drone footage',
    lumaParams: { aspect_ratio: '16:9', duration: 5 }
  });

  console.log('Job submitted:', job.jobId);

  // Wait for completion (polls until COMPLETED, or use webhooks)
  const finished = await client.jobs.waitFor(job.jobId, {
    onProgress: (j) => console.log('Progress:', j.progress ?? 0, '%')
  });

  console.log('Video ready:', finished.result.videoUrl);
}

generateVideo();

example.py

from apiframe import Apiframe

# Initialize the client
client = Apiframe(api_key='your_api_key_here')

# Submit a Luma Ray video-generation job
job = client.videos.generate(
    model='luma-ray-2',
    prompt='cinematic shot of a sunset over mountains, golden hour lighting, drone footage',
    luma_params={'aspect_ratio': '16:9', 'duration': 5},
)

print(f"Job submitted: {job['jobId']}")

# Wait for completion (polls until COMPLETED, or use webhooks)
finished = client.jobs.wait_for(
    job['jobId'],
    on_progress=lambda j: print(f"Progress: {j.get('progress') or 0}%"),
)

print(f"Video ready: {finished['result']['videoUrl']}")

client.close()

example.php

<?php

require 'vendor/autoload.php';

use Apiframe\Apiframe;

$client = new Apiframe([
    'apiKey' => 'your_api_key_here'
]);

// Submit a Luma Ray video-generation job
$job = $client->videos->generate([
    'model' => 'luma-ray-2',
    'prompt' => 'cinematic shot of a sunset over mountains, golden hour lighting, drone footage',
    'lumaParams' => ['aspect_ratio' => '16:9', 'duration' => 5],
]);

echo "Job submitted: {$job['jobId']}\n";

// Wait for completion (polls until COMPLETED, or use webhooks)
$finished = $client->jobs->waitFor($job['jobId'], [
    'onProgress' => function ($job) {
        echo 'Progress: ' . ($job['progress'] ?? 0) . "%\n";
    },
]);

echo "Video ready: {$finished['result']['videoUrl']}\n";

main.go

package main

import (
	"context"
	"fmt"
	"log"
	"os"

	"github.com/apiframe-ai/apiframe-go-sdk"
)

func main() {
	client, err := apiframe.NewClient(apiframe.Config{
		APIKey: os.Getenv("APIFRAME_API_KEY"),
	})
	if err != nil {
		log.Fatal(err)
	}

	ctx := context.Background()

	// Submit a Luma Ray video-generation job
	job, err := client.Videos.Generate(ctx, apiframe.VideosGenerateParams{
		Model:  "luma-ray-2",
		Prompt: "cinematic shot of a sunset over mountains, golden hour lighting, drone footage",
		LumaParams: &apiframe.LumaParams{
			AspectRatio: "16:9",
			Duration:    5,
		},
	})
	if err != nil {
		log.Fatal(err)
	}

	fmt.Printf("Job submitted: %s\n", job.JobID)

	// Wait for completion (polls until COMPLETED, or use webhooks)
	finished, err := client.Jobs.WaitFor(ctx, job.JobID, &apiframe.WaitForOptions{
		OnProgress: func(j *apiframe.Job) {
			fmt.Printf("Progress: %d%%\n", j.Progress)
		},
	})
	if err != nil {
		log.Fatal(err)
	}

	fmt.Printf("Video ready: %s\n", finished.Result.VideoURL)
}

terminal

curl -X POST https://api.apiframe.ai/v2/videos/generate \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "luma-ray-2",
    "prompt": "cinematic shot of a sunset over mountains, golden hour lighting, drone footage",
    "lumaParams": { "aspect_ratio": "16:9", "duration": 5 }
  }'

Get Your API Key Read Documentation

What Can You Build with the Luma AI API?

Real-world applications powered by Luma AI through Apiframe.

Marketing & Advertising

Produce video ads and campaign content on demand. Spin up creative variations to A/B test and optimize performance at scale.

Social Media Content

Make engaging clips for TikTok, Instagram Reels, and YouTube Shorts, then pair them with AI music and smooth motion in every cut.

Film & Video Production

Build concept videos, storyboards, and pre-visualization. Explore creative directions and preview shots before committing to full production.

Game Development

Produce cinematics, trailers, and promos for games, plus concept animations and cutscene previsualization with help from Midjourney art.

SaaS & App Integration

Add AI video generation to your product as a feature. Your users render videos in the browser without leaving the application.

E-Commerce & Product Videos

Render product demos and lifestyle content from a single image url, and showcase products in motion without expensive shoots.

Education & Training

Build educational videos, visual explanations, and training material. Learners get engaging content that improves how they learn.

Real Estate & Architecture

Visualize property walkthroughs and architectural concepts. Build immersive tours hosted on our CDN, with browser playback for clients anywhere.

Get Started in 3 Simple Steps

From signup to your first generated video in minutes.

Sign Up & Get API Key

Create your account with email or GitHub, then grab your api key from the dashboard in minutes.

Make Your First Video via the API

Send your first request with our sample code. Set the prompt, aspect ratio, and a few optional details to fit your scene.

Receive Your Video

Once the job finishes, download your MP4 in high quality. Every file is hosted on our CDN, so you can find it later anytime.

Create Free Account

Why Apiframe vs Other Luma AI APIs

See how Apiframe compares to alternative Luma AI API providers.

Features	Apiframe starts at $19/mo	Luma Direct starts at $9.99/mo	Replicate Pay-per-use	AWS Bedrock Enterprise pricing
Full Luma Access	Ray 3 / Ray 3.14	Full access	Limited models	Ray2 only
Multiple AI Models	15+ models in one API	Luma only	Multiple models	Multiple models
Text to Video	Full support	Full support	Supported	Supported
Image to Video	Full support	Full support	Supported	Supported
Keyframe Control	Start & end frames	Supported	Limited	Supported
Video Extension	Up to 9 seconds	Supported	Limited	Supported
Webhook Support	Full support	Not available	Supported	Supported
Official SDKs	Node, Python, PHP, Go	None	Python only	AWS SDKs
Unified Billing	All models, one bill	Luma only	Unified	AWS billing
Free Trial	Free credits	30 free generations	Limited	No free tier
Support	Live Chat + Discord	Discord community	Email + Docs	AWS support tiers

How Does Luma AI Compare to Other AI Models?

Choose the right model for your use case. All models available through Apiframe.

Features	Luma AI (via Apiframe)	Runway Gen-3 Alpha	Kling 1.5	Pika 1.5	OpenAI Sora
Best For	Cinematic videos, natural motion, coherent physics	Professional video editing, creative control	High-fidelity synthesis, speed-focused	Quick iterations, stylized content	Long-form, photorealistic videos
Latest Model	Ray 3.14 (Dream Machine)	Gen-3 Alpha	Kling 1.5	Pika 1.5	Sora
Official API	Yes (via Apiframe)	Yes	Yes	Yes	ChatGPT only
Video Quality	Best (16-bit HDR)	Excellent	Very good	Good (480p-1080p)	Best
Motion Coherence	Best	Excellent	Good	Good	Best
Video Length	5-9 seconds	5-10 seconds	5-10 seconds	3-5 seconds	Up to 20 seconds
Generation Speed	30-120 seconds	60-180 seconds	30-60 seconds (fastest)	60-120 seconds	2-5 minutes
Camera Control	Full control	Best (Motion Brush)	Supported	Limited	Supported
Image to Video	Excellent	Supported	Supported	Supported	Supported
Free Tier	300 credits	125 credits (one-time)	66 credits/day	80 credits/month	No (ChatGPT Plus required)
Pricing	$19/mo (Apiframe)	From $12/mo	Credits-based	From $8/mo	$20-200/mo (ChatGPT)
Best Use Cases	Ads, social media, product videos	Film, professional content	High-volume, quick turnaround	Social content, quick edits	Cinematic, long-form content

All models accessible through a single Apiframe API key. View full pricing details →

Which Model is for You?

Choose Luma AI (via Apiframe) if you need:

Ultra-realistic videos with natural motion.
Coherent physics and cinematic quality.
16-bit HDR color output for professional use.
Powerful image-to-video transformation.
Multiple AI models through one unified API.

Best for: Marketing agencies, content creators, SaaS products, video production.

Choose Runway Gen-3 Alpha if you need:

Advanced camera and motion control.
Professional video editing features (Aleph).
Motion Brush for precise animation.
Established platform with large community.
Direct integration with editing workflows.

Best for: Film production, professional editors, creative agencies.

Choose Kling AI if you need:

Fastest generation speeds.
Cost-effective high-volume production.
Quick turnaround for iterations.
Good quality at scale.
Budget-conscious video generation.

Best for: High-volume apps, social media automation, quick prototyping.

Choose Pika 1.5 if you need:

Quick, stylized content creation.
Simple interface for beginners.
Fast iteration on ideas.
Social media-optimized outputs.
Budget-friendly experimentation.

Best for: Individual creators, social media managers, hobbyists.

Choose OpenAI Sora if you need:

Long-form video generation (up to 60s).
Photorealistic output quality.
Complex scene understanding.
State-of-the-art capabilities.
Integration with OpenAI ecosystem.

Best for: Film production, premium content, cutting-edge projects.

Trusted by Developers Worldwide

See what developers are saying about our Luma AI API.

★★★★★

The API works very well

The API works very well, it is fast and returns the necessary for the applications. Its application is easy and support responds quickly.

Fernando

Manager

★★★★★

Easy to setup API

Very easy to set up. Everything works fast.

Aleksandre K.

Engineer

★★★★★

Support is fast and helpful

Support is fast and the API is easy to implement.

G2 Reviewer

Developer

Luma AI API Pricing and Plans

Simple, transparent pricing. No hidden fees. Pay only for what you use.

Free

20 credits

Get Started

All Luma AI features
API access
Webhook support
Integrations

Basic Plan

$39 SAVE $20

$19 /mo

1,000 credits/month

Get Started

All Luma AI features
API access
Webhook support
Integrations

Popular

Starter Plan

$199 SAVE $100

$99 /mo

5,500 credits/month

Get Started

All Luma AI features
API access
Webhook support
Integrations

Growth Plan

$399 SAVE $200

$199 /mo

12,000 credits/month

Get Started

All Luma AI features
API access
Webhook support
Integrations

50% OFF

Scale 1

High-volume pricing for enterprise customers with dedicated support and custom SLA.

$2,499 /mo

120,000 image credits/month

Scale 1 Scale 2 Scale 3

Get 50% OFF

Need more credits? You can buy additional credits at any time.

Frequently Asked Questions

Common questions about the Luma AI API.

What is the Luma API?

The Luma API is a REST interface for programmatic video generation on the Dream Machine models: the Ray 3 family, with Ray 3.14 as the latest iteration. A few simple HTTP requests turn text prompts and images into ultra-realistic videos with natural motion and coherent physics. You can find the full request and response details in the docs.

Does Luma AI have an official API?

Yes, Luma AI offers an official API. However, Apiframe provides a simplified wrapper with extras like webhook events, multiple SDKs, no-code integrations, and unified billing across 15+ AI models, making integration faster and more developer-friendly.

How much does Luma API cost?

Through Apiframe, the Luma API starts at $19/month for 3,000 credits (~10-58 videos). A free tier with 300 credits helps you get started, and higher-volume plans add capacity for larger projects. See current information on each plan before you commit.

What is Luma Dream Machine?

Dream Machine is Luma AI's flagship text-to-video model launched in June 2024. Built on a multimodal transformer architecture trained directly on videos, it produces physically accurate, consistent scenes with natural motion.

What is Luma Ray 3.14?

Ray 3.14, released January 26, 2026, is the current top iteration of Luma's Ray 3 family. It adds native 1080p output, generates up to 4x faster, and is about 3x cheaper at 720p than base Ray 3, while keeping Ray 3's reasoning, 16-bit HDR color, and Ray 3 Modify for video-to-video with keyframe and character-reference controls.

What video formats does Luma API support?

Luma API generates high-quality MP4 videos. You can specify various aspect ratios including 16:9, 9:16, 1:1, and more to optimize for different platforms like YouTube, TikTok, Instagram, and others.

How long can Luma-generated videos be?

Luma AI can generate videos up to 5-9 seconds with the Ray 3 family. You can extend videos using the extend feature to create longer sequences by chaining multiple generations together.

Can I turn images into videos with Luma?

Yes, Luma AI excels at image-to-video generation. You can provide a starting image and the AI will animate it with natural motion, maintaining consistency with the original image while adding dynamic movement.

What is keyframe control in Luma API?

Keyframe control allows you to define start and end frames for your video generation. This gives you precise control over the narrative flow, letting you specify exactly how the video should begin and end.

Does the Luma API support webhooks?

Yes, Apiframe provides full webhook support for Luma API. You can receive real-time notifications when your video generation is complete, eliminating the need for polling and enabling async workflows.

What SDKs are available for Luma API?

Apiframe provides official SDKs for Node.js, Python, PHP, and Go. You can also use direct HTTP requests with any programming language or integrate via no-code platforms like Zapier and Make.

Can I use Luma-generated videos commercially?

Yes, videos generated through Apiframe's Luma API can be used commercially according to Luma AI's terms of service. Always review the latest terms for specific commercial use guidelines.

How long does video generation take with Luma?

Typical generation times range from 30-120 seconds depending on video length and complexity. Ray 3.14 is up to 4x faster than base Ray 3, and Draft Mode enables even quicker iterations, while full-quality renders take slightly longer.

Is there a free trial for Luma API?

Yes, Apiframe offers a free tier with 300 credits per month, enough for roughly 1-5 Luma videos (depending on resolution and duration). No credit card required: create an account and start rendering right away.

How does Luma AI compare to other video generators?

Luma AI is known for exceptional motion coherence, physics accuracy, and cinematic quality. The Ray 3 family was first to support 16-bit HDR output, and Ray 3.14 adds native 1080p with 4x faster generation. Compared to Runway and Kling, Luma offers superior natural motion and realistic physics simulation.

What makes Luma AI's physics simulation special?

Luma's models are trained directly on video data, enabling them to understand and reproduce real-world physics naturally. This results in videos where objects move, interact, and behave in physically plausible ways without artifacts.

Still have questions?

Contact Support Join Discord

Start Building AI Videos Today

Tap into Luma alongside Midjourney, Runway, Kling, and 10+ other AI models through one API and a single key.

Free tier with 300 credits

No credit card required

5-minute integration

Production-ready from day one

Get Started Free Read Documentation

Questions? Join our Discord or contact sales.

Luma API: AI Video Generation

Does Luma AI Offer a Dream Machine API?

Everything You Need in a Luma AI API

Dream Machine Text to Video

Image to Video

Ray 3 Modify (Video to Video)

Keyframe Control

Extend & Loop

Camera Control

Variable Aspect Ratios

Webhook Support

Multiple SDKs

Quick Start – Get Running in 5 Minutes

What Can You Build with the Luma AI API?

Marketing & Advertising

Social Media Content

Film & Video Production

Game Development

SaaS & App Integration

E-Commerce & Product Videos

Education & Training

Real Estate & Architecture

Get Started in 3 Simple Steps

Sign Up & Get API Key

Make Your First Video via the API

Receive Your Video

Why Apiframe vs Other Luma AI APIs

How Does Luma AI Compare to Other AI Models?

Which Model is for You?

Choose Luma AI (via Apiframe) if you need:

Choose Runway Gen-3 Alpha if you need:

Choose Kling AI if you need:

Choose Pika 1.5 if you need:

Choose OpenAI Sora if you need:

Trusted by Developers Worldwide

The API works very well

Easy to setup API

Support is fast and helpful

Luma AI API Pricing and Plans

Free

Basic Plan

Starter Plan

Growth Plan

Scale 1

Frequently Asked Questions

Other AI Models

Midjourney API

Suno API

Wan Image

Start Building AI Videos Today

Luma API:
AI Video Generation