🚀 Luma API MCP 使用说明
本项目提供了Luma API MCP的使用指导，帮助你通过Claude桌面应用程序或其他MCP客户端，利用Luma的API进行图像和视频的生成，满足多样化的创作需求。
🚀 快速开始
- 安装与配置：下载并安装Claude桌面应用程序或其他任何MCP客户端，接着从 https://lumalabs.ai/api/keys 获取API密钥，最后运行
sh setup.sh，系统会提示输入API密钥，将之前获取的密钥粘贴进去即可完成配置。
- 启动运行：打开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秒。
