luma-api-mcp

🚀 Luma API MCP 使用说明

本项目提供了Luma API MCP的使用指导，帮助你通过Claude桌面应用程序或其他MCP客户端，利用Luma的API进行图像和视频的生成，满足多样化的创作需求。

🚀 快速开始

1. 安装与配置：下载并安装Claude桌面应用程序或其他任何MCP客户端，接着从 https://lumalabs.ai/api/keys 获取API密钥，最后运行 sh setup.sh，系统会提示输入API密钥，将之前获取的密钥粘贴进去即可完成配置。
2. 启动运行：打开Claude桌面应用程序或任何MCP客户端，准备使用API进行创作。

✨ 主要特性

创建图像

| 参数 | 说明 | | ---- | ---- | | prompt | 文本描述，用于指定生成图像的内容 | | aspect_ratio | 可选值为 "1:1", "16:9", "9:16", "4:3", "3:4", "21:9", "9:21"，默认值为 "16:9" | | model | 可选值为 "photon-1", "photon-flash-1"，默认值为 "photon-1" | | image_ref | 图像URL列表，可带有权重影响生成，可选参数，最多8个 | | style_ref | 单张风格参考图像URL，可选参数，最多1个 | | character_ref | 角色图片URL列表，可选参数，最多4个 | | modify_image_ref | 待修改的单张图像URL，可选参数，最多1个 |

创建视频

| 参数 | 说明 | | ---- | ---- | | prompt | 文本描述，用于指定生成视频的内容 | | aspect_ratio | 可选值为 "1:1", "16:9", "9:16", "4:3", "3:4", "21:9", "9:21"，默认值为 "16:9" | | model | 可选值为 "ray-2", "ray-flash-2", "ray-1-6"，默认值为 "ray-2" | | loop | 是否循环播放，布尔值，默认值为 false | | resolution | 可选值为 "540p", "720p", "1080p", "4k"，默认值为 "720p" | | duration | 可选值为 "5s", "9s"，默认值为 "5s" | | frame0_image | 第一帧图像URL，可选参数 | | frame1_image | 最后一帧图像URL，可选参数 | | frame0_id | 第一帧生成ID，可选参数 | | frame1_id | 最后一帧生成ID，可选参数 |

🔧 技术细节

• 关键帧控制：提供 frame0_image/frame1_image 参数可以更好地控制视频的起始和结束点，让生成的视频更符合预期。
• 生成时间：视频生成时间根据分辨率和时长不同，通常需要15 - 60秒；图像生成时间根据不同模型复杂度，通常需要5 - 15秒。