MCP ExplorerExplorer

Luma Api Mcp

@lumalabson 9 months ago
19 MIT
FreeCommunity
AI Systems
#api#genai#image#luma#lumaai#mcp#mcp-server#mcp-servers#model-context-protocol#photon#python#ray#video
Powered by Ray (video) and Photon (image) models by Luma AI

Overview

What is Luma Api Mcp

luma-api-mcp is an API powered by Ray (video) and Photon (image) models developed by Luma AI, designed for generating images and videos based on user-defined prompts.

Use cases

Use cases include generating promotional videos, creating unique artwork based on textual descriptions, and modifying existing images or videos to fit specific styles or themes.

How to use

To use luma-api-mcp, install the Claude Desktop App or any MCP client, obtain an API Key from https://lumalabs.ai/api/keys, and run the setup script. After setup, you can open the client to start generating content.

Key features

Key features include the ability to create images and videos with customizable prompts, aspect ratios, models, and reference images. It supports various resolutions and durations for video generation.

Where to use

luma-api-mcp can be used in creative industries such as digital art, marketing, content creation, and entertainment, where visual content generation is required.

Content

Luma API MCP

Setup

  1. Install Claude Desktop App or any MCP client
  2. Get API Key from https://lumalabs.ai/api/keys
  3. Run sh setup.sh, here it will ask the API Key - paste it from 2.

Run

Open Claude Desktop or any MCP client

Features

Create Image

  • prompt: text
  • aspect_ratio: “1:1”, “16:9”, “9:16”, “4:3”, “3:4”, “21:9”, “9:21” (default: “16:9”)
  • model: “photon-1”, “photon-flash-1” (default: “photon-1”)
  • image_ref: list of image URLs with weights to influence generation (optional), max 8
  • style_ref: single image URL with weight to influence style (optional), max 1
  • character_ref: list of character image URLs (optional), max 4
  • modify_image_ref: single image URL to modify with weight (optional), max 1

Create Video

  • prompt: text
  • aspect_ratio: “1:1”, “16:9”, “9:16”, “4:3”, “3:4”, “21:9”, “9:21” (default: “16:9”)
  • model: “ray-2”, “ray-flash-2”, “ray-1-6” (default: “ray-2”)
  • loop: boolean (default: false)
  • resolution: “540p”, “720p”, “1080p”, “4k” (default: “720p”)
  • duration: “5s”, “9s” (default: “5s”)
  • frame0_image: image URL (optional)
  • frame1_image: image URL (optional)
  • frame0_id: generation ID (optional)
  • frame1_id: generation ID (optional)

Technical Notes

  • Keyframes: Providing frame0_image/frame1_image gives more control over video start/end points
  • Video Response Time: Typical video generation takes 15-60 seconds depending on duration and resolution
  • Image Response Time: Typical generation takes 5-15 seconds depending on model complexity

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers