Luma 视频生成
通过 AceDataCloud 的 Luma Dream Machine API 生成 AI 视频。
设置: 请参阅 认证 了解令牌设置。
快速开始
curl -X POST https://api.acedata.cloud/luma/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"prompt": "a drone flying over a mountain lake at sunrise", "action": "generate", "callback_url": "https://api.acedata.cloud/health"}'
异步: 请参阅 异步任务轮询。通过
POST /luma/tasks并传入{"task_id": "..."}进行轮询。
工作流
1. 文本转视频
纯从文本描述生成视频。
POST /luma/videos
{
"prompt": "a timelapse of flowers blooming in a garden",
"action": "generate",
"aspect_ratio": "16:9",
"loop": false,
"enhancement": true
}
2. 图像转视频
使用起始和/或结束参考图像引导生成。
POST /luma/videos
{
"prompt": "the scene comes alive with gentle wind",
"action": "generate",
"start_image_url": "https://example.com/scene.jpg",
"end_image_url": "https://example.com/scene-end.jpg",
"aspect_ratio": "16:9"
}
3. 扩展视频
使用新的提示词扩展现有视频。
POST /luma/videos
{
"action": "extend",
"video_id": "existing-video-id",
"prompt": "the camera continues forward through the forest"
}
宽高比
| 比例 | 使用场景 |
|---|---|
16:9 | 横向(默认)—— YouTube、电视 |
9:16 | 纵向—— TikTok、Instagram 故事 |
1:1 | 正方形——社交媒体 |
4:3 | 经典——演示文稿 |
21:9 | 超宽——电影级 |
参数
| 参数 | 类型 | 默认值 | 描述 |
|---|---|---|---|
prompt | string | — | 视频的文本描述(必填) |
action | string | "generate" | "generate" 或 "extend" |
aspect_ratio | string | "16:9" | 视频宽高比 |
loop | bool | false | 创建无缝循环 |
enhancement | bool | true | 增强提示以获得更好结果 |
start_image_url | string | — | 第一帧的参考图像 |
end_image_url | string | — | 最后一帧的参考图像 |
video_id | string | — | 要扩展的视频 ID(与 video_url 互斥) |
video_url | string | — | 要扩展的视频 URL(与 video_id 互斥) |
timeout | number | — | API 返回数据的超时时间(秒) |
callback_url | string | — | 异步通知的 Webhook URL |
注意事项
enhancement: true(默认)会提升提示词质量,但可能改变你的意图——若需严格遵循原始提示,请设为false- 起始/结束图像 URL 必须公开可访问
loop: true创建无缝循环视频——适合背景和社交媒体- 扩展视频时必须提供已完成生成的
video_id或video_url - 视频生成时间根据复杂程度约为 1-5 分钟
- 起始和结束图像均为可选——可以仅使用其中一张来提供部分引导
MCP:
pip install mcp-luma| 托管:https://luma.mcp.acedata.cloud/mcp| 请参阅 所有 MCP 服务器