Luma API MCP

Name: Luma API MCP
Author: lumalabs

@lumalabs

代码仓库主页

关于 Luma API MCP

#python #api #image #video #mcp #photon #ray #luma #lumaai #genai #model-context-protocol #mcp-servers #mcp-server

基本信息

分类

开发工具

许可证

MIT

运行时

python

传输方式

stdio

发布者

lumalabs

配置

暂无标准配置

该服务器的 README 中没有可解析的 MCP 配置块，请前往代码仓库查看安装说明。

代码仓库

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Luma API MCP?

Luma API MCP is a Model Context Protocol server that integrates with Luma’s AI generation API to create images and videos from text prompts. It is designed for users of MCP‑compatible clients (e.g., Claude Desktop) who want to generate visual content programmatically with support for image references, style control, and keyframe‑based video.

How to use Luma API MCP?

Install by running setup.sh and pasting your API key (obtain it from https://lumalabs.ai/api/keys). Then open any MCP client, such as Claude Desktop, and invoke the “Create Image” or “Create Video” tools with the parameters described in the README.

Key features of Luma API MCP

Create images with custom prompts and aspect ratios
Create videos with configurable duration, resolution, and looping
Supports multiple models: photon‑1/flash for images, ray‑2/flash/1‑6 for videos
Reference up to eight images, one style, four character images per generation
Video keyframe control using images or prior generation IDs
Typical generation times: images 5–15 s, videos 15–60 s

Use cases of Luma API MCP

Generate AI images for design concepts and marketing materials
Produce short AI videos with consistent start/end frames
Integrate visual content creation into automated MCP workflows
Rapidly prototype variations using prompt and reference parameters

FAQ from Luma API MCP

Where do I get an API key?

Obtain your API key from https://lumalabs.ai/api/keys.

What MCP clients are supported?

Any MCP client works; the README explicitly mentions Claude Desktop.

What are the default generation settings?

Images default to model photon‑1 and aspect ratio 16:9. Videos default to model ray‑2, resolution 720p, duration 5s, and loop false.

How long does generation take?

Typical image generation takes 5–15 seconds; video generation takes 15–60 seconds depending on duration and resolution.

Can I use reference images?

Yes. For images you can provide up to 8 image references, 1 style reference, up to 4 character references, and 1 image to modify. For videos you can supply start/end frame images or generation IDs.