申请和使用
要使用 Luma Videos API，首先可以到 Luma Videos Generation API 页面点击「Acquire」按钮，获取请求所需要的凭证：
如果你尚未登录或注册，会自动跳转到登录页面邀请您来注册和登录，登录注册之后会自动返回当前页面。
在首次申请时会有免费额度赠送，可以免费使用该 API。
基本使用
想要生成什么视频，可以任意输入一段文字，比如我想生成一个关于宇航员穿梭于太空和火山之间的视频，就可以输入Astronauts shuttle from space to volcano，如图所示：
prompt：生成视频的提示词。aspect_ratio：视频宽高比，默认 16:9。end_image_url：可选，指定尾帧。enhancement：可选，清晰度增强开关。loop：是否生成循环视频，默认 false。timeout：可选，超时秒数。callback_url：异步回调地址。
- success：生成是否成功，如果成功则为
true，否则为false - task_id：此处视频生成任务的唯一ID
- video_id：此处视频生成任务产生的视频唯一ID
- prompt：此处视频生成任务的关键词
- video_url：此处视频生成任务的结果视频链接
- video_height：生成后的视频封面图片的高度
- video_width：生成后的视频封面图片的宽度
- state：此处视频生成任务的状态，如果任务完成的话则为
completed。 - thumbnail_url：生成后的视频封面图片的链接
- thumbnail_width：生成后的视频封面图片的宽度
- thumbnail_height：生成后的视频封面图片的高度
自定义首尾帧生成
如果想通过自定义视频的首尾帧来生成视频，可以输入首尾帧的图片链接： 这时候视频首帧start_image_url 字段可以传入以下图片作为视频的首帧：
接下来我们要根据首尾帧、关键词自定义生成视频，就可以指定如下内容：
- action：视频生成任务的行为，通常是普通生成
generate和扩展生成extend，默认为generate。 - start_image_url：指定生成视频的首帧。
- end_image_url：指定生成视频的尾帧。
- prompt：生成视频的关键词内容。
填写样例如下：
视频扩展功能
如果想对生成的视频进行继续生成的话，可以将参数action 设置为 extend ，并且输入需要继续生成视频的ID或者视频链接，视频ID和视频链接的获取是根据基本使用来获取，如下图所示：
注意，这里的视频中要想继续生成视频的话必须上传视频链接或视频的ID，下面演示使用视频ID来进行扩展，接下来我们要必须填关键词自定义生成视频，就可以指定如下内容：video_id和video_url是生成后视频的ID和视频链接，如果你不知道如何生成视频，可以参考上文的基本使用来生成视频。
- action：此时扩展视频的行为，在这应为
extend。 - prompt：需要扩展视频的关键词。
- video_url：需要扩展生成视频的链接。
- video_id：需要扩展生成视频的唯一ID。
- end_image_url：扩展生成视频可指定尾帧的图片链接，可选参数。
接下来在上面的基础上添加尾帧图片信息，具体的如下所示：
异步回调
由于 Luma 生成视频的时间相对较长，大约需要 1-2 分钟，如果 API 长时间无响应，HTTP 请求会一直保持连接，导致额外的系统资源消耗，所以本 API 也提供了异步回调的支持。 整体流程是：客户端发起请求的时候，额外指定一个callback_url 字段，客户端发起 API 请求之后，API 会立马返回一个结果，包含一个 task_id 的字段信息，代表当前的任务 ID。当任务完成之后，生成音乐的结果会通过 POST JSON 的形式发送到客户端指定的 callback_url，其中也包括了 task_id 字段，这样任务结果就可以通过 ID 关联起来了。
下面我们通过示例来了解下具体怎样操作。
首先，Webhook 回调是一个可以接收 HTTP 请求的服务，开发者应该替换为自己搭建的 HTTP 服务器的 URL。此处为了方便演示，使用一个公开的 Webhook 样例网站 https://webhook.site/，打开该网站即可得到一个 Webhook URL，如图所示：
callback_url 为上述 Webhook URL，同时填入 prompt，如图所示：
内容如下：
task_id 字段，其他的字段都和上文类似，通过该字段即可实现任务的关联。