luma-video

Luma 视频生成

通过 AceDataCloud 的 Luma Dream Machine API 生成 AI 视频。

首次设置

1. 使用 clawhub install @acedatacloud/luma 安装官方 Skill。确认 ClawHub 发布者是 @acedatacloud。
2. 登录 AceDataCloud → 应用，打开 通用应用，检查 Luma 访问权限、余额和当前定价。复制其 API 密钥，或选择 管理密钥 → 创建，创建单独的密钥。复制密钥值时不要包含 Bearer ；platform-... 管理令牌不是服务 API 密钥。
3. 如果启用了 允许的 API 限制，请加入 /luma/videos 和 /luma/tasks。下方的高级工作流可能会调用其他路由。
4. 在 OpenClaw Gateway 主机上，将 ACEDATACLOUD_API_TOKEN=your_api_key_here 写入 ~/.openclaw/.env，然后重启 Gateway 并开启新会话。若要直接在终端测试，请在该 Shell 中运行 export ACEDATACLOUD_API_TOKEN="your_api_key_here"。切勿将密钥放入提示词或提交 .env 文件。
5. 运行下方的 快速开始。如果此工作流返回任务 ID，请查询同一任务，直到任务完成；不要仅为查看进度而再次提交相同的计费请求。

密钥设置、首次运行和故障排除图解 · 令牌详情

快速开始

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", "async": true}'

异步： 请参阅异步任务轮询。通过 POST /luma/tasks 轮询，并传入 {"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 Stories
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 服务