Luma Dream Machine API Guide: Build AI Video Apps with Ray 2 in 2026

import requests

LUMA_API_KEY = "your-luma-api-key"
BASE_URL = "https://api.lumalabs.ai/dream-machine/v1"

headers = {
    "Authorization": f"Bearer {LUMA_API_KEY}",
    "Content-Type": "application/json"
}

def create_generation(prompt: str, aspect_ratio: str = "16:9",
                      loop: bool = False):
    """Create a new video generation"""
    response = requests.post(
        f"{BASE_URL}/generations",
        headers=headers,
        json={
            "prompt": prompt,
            "aspect_ratio": aspect_ratio,
            "loop": loop
        }
    )
    response.raise_for_status()
    return response.json()

# Generate a video
gen = create_generation(
    prompt="Aerial drone shot flying over a misty mountain range at sunrise, "
           "golden light breaking through clouds, cinematic",
    aspect_ratio="16:9"
)
generation_id = gen["id"]
print(f"Generation started: {generation_id}")

def image_to_video(image_url: str, prompt: str, 
                   aspect_ratio: str = "16:9"):
    """Animate a static image"""
    response = requests.post(
        f"{BASE_URL}/generations",
        headers=headers,
        json={
            "prompt": prompt,
            "keyframes": {
                "frame0": {
                    "type": "image",
                    "url": image_url
                }
            },
            "aspect_ratio": aspect_ratio
        }
    )
    response.raise_for_status()
    return response.json()

# Animate a landscape photo
gen = image_to_video(
    image_url="https://example.com/landscape.jpg",
    prompt="Gentle wind moving through the grass, clouds drifting slowly, "
           "birds flying in the distance"
)

# Orbit around a subject
gen = create_generation(
    prompt="A marble statue in a museum, camera slowly orbiting 360 degrees "
           "around the statue, dramatic lighting"
)

# Dolly zoom (Vertigo effect)
gen = create_generation(
    prompt="A person standing in a long hallway, dolly zoom effect, "
           "background stretching while subject stays same size"
)

# Crane shot
gen = create_generation(
    prompt="Starting from ground level looking at flowers, camera cranes up "
           "to reveal a vast mountain landscape behind"
)

# Tracking shot
gen = create_generation(
    prompt="Camera tracking alongside a runner on a beach, steady lateral "
           "movement, golden hour lighting"
)

def controlled_generation(start_image: str, end_image: str, 
                         prompt: str):
    """Generate video with defined start and end frames"""
    response = requests.post(
        f"{BASE_URL}/generations",
        headers=headers,
        json={
            "prompt": prompt,
            "keyframes": {
                "frame0": {
                    "type": "image",
                    "url": start_image
                },
                "frame1": {
                    "type": "image",
                    "url": end_image
                }
            }
        }
    )
    return response.json()

# Morph between two product shots
gen = controlled_generation(
    start_image="https://example.com/product_angle1.jpg",
    end_image="https://example.com/product_angle2.jpg",
    prompt="Smooth camera rotation revealing the product from a new angle"
)

import time

def wait_and_download(generation_id: str, output_path: str,
                      timeout: int = 300):
    """Wait for generation and download the video"""
    start = time.time()
    
    while time.time() - start < timeout:
        response = requests.get(
            f"{BASE_URL}/generations/{generation_id}",
            headers=headers
        )
        data = response.json()
        
        state = data.get("state")
        
        if state == "completed":
            video_url = data["assets"]["video"]
            
            # Download video
            video_resp = requests.get(video_url)
            with open(output_path, "wb") as f:
                f.write(video_resp.content)
            
            print(f"Downloaded to {output_path}")
            return data
            
        elif state == "failed":
            failure = data.get("failure_reason", "Unknown error")
            raise Exception(f"Generation failed: {failure}")
        
        # Progress logging
        print(f"State: {state} ({int(time.time() - start)}s elapsed)")
        time.sleep(5)
    
    raise TimeoutError("Generation timed out")

# Usage
result = wait_and_download(generation_id, "output_video.mp4")

const axios = require('axios');
const fs = require('fs');

const LUMA_API_KEY = 'your-luma-api-key';
const BASE_URL = 'https://api.lumalabs.ai/dream-machine/v1';

const headers = {
  'Authorization': `Bearer ${LUMA_API_KEY}`,
  'Content-Type': 'application/json'
};

async function generateVideo(prompt, options = {}) {
  // Create generation
  const { data: gen } = await axios.post(
    `${BASE_URL}/generations`,
    {
      prompt,
      aspect_ratio: options.aspectRatio || '16:9',
      loop: options.loop || false,
      ...(options.keyframes && { keyframes: options.keyframes })
    },
    { headers }
  );
  
  console.log(`Generation started: ${gen.id}`);
  
  // Poll for completion
  while (true) {
    const { data: status } = await axios.get(
      `${BASE_URL}/generations/${gen.id}`,
      { headers }
    );
    
    if (status.state === 'completed') {
      return status.assets.video;
    } else if (status.state === 'failed') {
      throw new Error(`Failed: ${status.failure_reason}`);
    }
    
    await new Promise(r => setTimeout(r, 5000));
  }
}

// Usage
(async () => {
  const videoUrl = await generateVideo(
    'A cozy cabin in the woods during snowfall, ' +
    'warm light from windows, camera slowly pushing in'
  );
  console.log(`Video URL: ${videoUrl}`);
})();

import openai

client = openai.OpenAI(
    api_key="sk-cr-your-key",
    base_url="https://crazyrouter.com/v1"
)

response = client.chat.completions.create(
    model="luma-ray-2",
    messages=[{
        "role": "user",
        "content": "Generate video: Camera orbiting around a crystal vase "
                   "on a pedestal, caustic light patterns, white background"
    }]
)

# cURL via Crazyrouter
curl https://crazyrouter.com/volc/v1/contents/generations/tasks \
  -H "Authorization: Bearer sk-cr-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "luma-ray-2",
    "prompt": "Timelapse of a flower blooming, macro lens, studio lighting",
    "aspect_ratio": "9:16"
  }'

# E-commerce product showcase
gen = create_generation(
    prompt="Camera slowly orbiting around a luxury watch on a black velvet "
           "surface, dramatic side lighting, reflections on the crystal face, "
           "shallow depth of field"
)

# Interior walkthrough
gen = image_to_video(
    image_url="https://example.com/living_room.jpg",
    prompt="Camera slowly panning across the living room, revealing the "
           "kitchen area, natural light from large windows, smooth steadicam"
)

# Vertical format for TikTok/Reels
gen = create_generation(
    prompt="A coffee being poured in slow motion, steam rising, "
           "close-up macro shot, warm tones",
    aspect_ratio="9:16"
)