Luma 视频生成 API 对接说明

Luma 视频生成 API 对接说明

随着 AI 的应用变广，各类 AI 程序已逐渐普及。AI 已逐渐深入到人们的工作生活方方面面。而 AI 涉及的行业也越来越多，从最初的写作，到医疗教育，再到现在的视频。

Luma 是一个专业高质量的视频生成平台，用户只需上传素材，即可根据不同风格和效果自动生成高质量视频。该 AI 视频生成器由来自知名科技公司的团队成员开发，目标是无需复杂的编辑工具，让每个人都能轻松制作出色的视频。

然而 Luma 官方是并没有提供 API 的，AceDataCloud 提供了一套 Luma 的 API，模拟对接了 Suno 官方，可以方便快捷地生成想要的视频。

申请和使用

要使用 Luma Videos API，首先可以到 Luma Videos Generation API 页面点击「Acquire」按钮，获取请求所需要的凭证：

如果你尚未登录或注册，会自动跳转到登录页面邀请您来注册和登录，登录注册之后会自动返回当前页面。

在首次申请时会有免费额度赠送，可以免费使用该 API。

基本使用

想要生成什么视频，可以任意输入一段文字，比如我想生成一个关于宇航员穿梭于太空和火山之间的视频，就可以输入 Astronauts shuttle from space to volcano，如图所示：

生成的代码如下：

可以点击「Try」按钮直接测试 API，稍等 1-2 分钟，结果如下：

json { "success": true, "task_id": "e4018a99-1522-4f24-9330-62c2a9b50b59", "video_id": "155838f8-7f1e-44d8-b387-192f3b4b509d", "prompt": "Astronauts shuttle from space to volcano", "video_url": "https://storage.cdn-luma.com/dream_machine/af94e7ca-da35-4b5f-a636-2d7254184d0d/watermarked_video0585de3737db946e5a0ac895384ecd180.mp4", "video_height": 752, "video_width": 1360, "state": "completed", "thumbnail_url": "https://platform.cdn.acedata.cloud/luma/e4018a99-1522-4f24-9330-62c2a9b50b59.jpg", "thumbnail_width": 1360, "thumbnail_height": 752 }

可以看到这时候我们就得到了这个视频的相关信息，包括视频ID、视频链接、视频封面等内容。

字段说明如下：

  • 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：生成视频的关键词内容。

填写样例如下：

填写完毕之后自动生成了代码如下：

对应的代码：

```python import requests

url = "https://api.acedata.cloud/luma/videos"

headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" }

payload = { "start_image_url": "https://cdn.zhishuyun.com/29cc6830-5291-4f13-a3af-413e45a8252e.png", "action": "generate", "prompt": "Astronauts shuttle from space to volcano" }

response = requests.post(url, json=payload, headers=headers) print(response.text) ```

得到的结果如下：

json { "success": true, "task_id": "12a18694-fd4b-47e7-9c50-34f30862cff6", "video_id": "0105c090-03a5-425a-8026-523341cd575b", "prompt": "Astronauts shuttle from space to volcano", "video_url": "https://platform.cdn.acedata.cloud/luma/12a18694-fd4b-47e7-9c50-34f30862cff6.mp4", "video_height": 656, "video_width": 1552, "state": "completed", "thumbnail_url": "https://platform.cdn.acedata.cloud/luma/12a18694-fd4b-47e7-9c50-34f30862cff6.jpg", "thumbnail_width": 1552, "thumbnail_height": 656 }

最后得到的结果与上文的类似的，生成的视频首帧包含了我们传入的图片，当然也可以同时传入首尾帧图片链接来生成视频，只需要在上面的基础上再加一个尾帧图片即可，尾帧的图片信息如下：

尾帧

填写样例如下：

最后得出如下结果：

json { "success": true, "task_id": "d1cb723a-e554-4775-94a4-bb6ae8c7ea67", "video_id": "6bebd0d2-f793-472e-9326-38528a9273bb", "prompt": "Astronauts shuttle from space to volcano", "video_url": "https://platform.cdn.acedata.cloud/luma/d1cb723a-e554-4775-94a4-bb6ae8c7ea67.mp4", "video_height": 656, "video_width": 1552, "state": "completed", "thumbnail_url": "https://platform.cdn.acedata.cloud/luma/d1cb723a-e554-4775-94a4-bb6ae8c7ea67.jpg", "thumbnail_width": 1552, "thumbnail_height": 656 }

结果与上文是类似的，生成的视频同时包含了首帧与尾帧的图片，这也就完成了自定义首尾帧来生成视频。

视频扩展功能

如果想对生成的视频进行继续生成的话，可以将参数 action 设置为 extend ，并且输入需要继续生成视频的ID或者视频链接，视频ID和视频链接的获取是根据基本使用来获取，如下图所示：

这时候可以看到视频的ID为：

"video_id": "0105c090-03a5-425a-8026-523341cd575b", "video_url": "https://platform.cdn.acedata.cloud/luma/12a18694-fd4b-47e7-9c50-34f30862cff6.mp4"

注意，这里的视频中 video_id 和 video_url 是生成后视频的ID和视频链接，如果你不知道如何生成视频，可以参考上文的基本使用来生成视频。

要想继续生成视频的话必须上传视频链接或视频的ID，下面演示使用视频ID来进行扩展，接下来我们要必须填关键词自定义生成视频，就可以指定如下内容：

  • action：此时扩展视频的行为，在这应为 extend 。
  • prompt：需要扩展视频的关键词。
  • video_url：需要扩展生成视频的链接。
  • video_id：需要扩展生成视频的唯一ID。
  • end_image_url：扩展生成视频可指定尾帧的图片链接，可选参数。

填写样例如下：

填写完毕之后自动生成了代码如下：

对应的Python代码：

```python import requests

url = "https://api.acedata.cloud/luma/videos"

headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" }

payload = { "action": "extend", "video_id": "0105c090-03a5-425a-8026-523341cd575b", "prompt": "Astronauts shuttle from space to volcano" }

response = requests.post(url, json=payload, headers=headers) print(response.text) ```

点击运行，可以发现会得到一个结果，如下：

json { "success": true, "task_id": "c6e529d1-a06d-4c12-91b2-c855135131c3", "video_id": "36908c49-c2bb-4a11-bd5a-b8512b004818", "prompt": "Astronauts shuttle from space to volcano", "video_url": "https://platform.cdn.acedata.cloud/luma/c6e529d1-a06d-4c12-91b2-c855135131c3.mp4", "video_height": 656, "video_width": 1552, "state": "completed", "thumbnail_url": "https://platform.cdn.acedata.cloud/luma/c6e529d1-a06d-4c12-91b2-c855135131c3.jpg", "thumbnail_width": 1552, "thumbnail_height": 656 }

可以看出该视频是在需要扩展的视频基础上进行扩展的，结果内容与上文的是一致的，这也就实现歌曲的继续生成功能。

当然我们也可以指定视频的链接来进行扩展生成，填如下信息：

运行后得到了如下结果：

json { "success": true, "task_id": "1dcb5902-a7be-4b77-ba5d-dd8ec82b26ca", "video_id": "f0187dc2-339f-4a08-a435-c3a3341f620a", "prompt": "Astronauts shuttle from space to volcano", "video_url": "https://platform.cdn.acedata.cloud/luma/1dcb5902-a7be-4b77-ba5d-dd8ec82b26ca.mp4", "video_height": 656, "video_width": 1552, "state": "completed", "thumbnail_url": "https://platform.cdn.acedata.cloud/luma/1dcb5902-a7be-4b77-ba5d-dd8ec82b26ca.jpg", "thumbnail_width": 1552, "thumbnail_height": 656 }

根据结果可以看出根据视频链接也可以实现视频扩展的功能。

最后我们还可以对扩展视频中指定一个尾帧图片来进行扩展，下面是尾帧图片信息：

尾帧

接下来在上面的基础上添加尾帧图片信息，具体的如下所示：

点击运行后得到如下信息：

json { "success": true, "task_id": "b816b2b4-c345-4673-9e19-83e91f91b643", "video_id": "c5400053-63e6-4206-8082-31cf9dd1e7ed", "prompt": "Astronauts shuttle from space to volcano", "video_url": "https://platform.cdn.acedata.cloud/luma/b816b2b4-c345-4673-9e19-83e91f91b643.mp4", "video_height": 656, "video_width": 1552, "state": "completed", "thumbnail_url": "https://platform.cdn.acedata.cloud/luma/b816b2b4-c345-4673-9e19-83e91f91b643.jpg", "thumbnail_width": 1552, "thumbnail_height": 656 }

可以看出，在上文扩展视频的基础上，还可以指定尾帧图片来进行扩展。

异步回调

由于 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，如图所示：

将此 URL 复制下来，就可以作为 Webhook 来使用，此处的样例为 https://webhook.site/0c87ca0e-cd74-4577-8d68-f2b80fbf8a13。

接下来，我们可以设置字段 callback_url 为上述 Webhook URL，同时填入 prompt，如图所示：

点击运行，可以发现会立即得到一个结果，如下：

json { "task_id": "732f8282-7cf8-401c-95f2-42c33aa079a6" }

稍等片刻，我们可以在 https://webhook.site/0c87ca0e-cd74-4577-8d68-f2b80fbf8a13 上观察到生成歌曲的结果，如图所示：

内容如下：

json { "success": true, "task_id": "732f8282-7cf8-401c-95f2-42c33aa079a6", "video_id": "4d8013c3-5de0-41aa-966e-0b1a51d1c633", "prompt": "Astronauts shuttle from space to volcano", "video_url": "https://platform.cdn.acedata.cloud/luma/732f8282-7cf8-401c-95f2-42c33aa079a6.mp4", "video_height": 752, "video_width": 1360, "state": "completed", "thumbnail_url": "https://platform.cdn.acedata.cloud/luma/732f8282-7cf8-401c-95f2-42c33aa079a6.jpg", "thumbnail_width": 1360, "thumbnail_height": 752 }

可以看到结果中有一个 task_id 字段，其他的字段都和上文类似，通过该字段即可实现任务的关联。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.rhkb.cn/news/485417.html

如若内容造成侵权/违法违规/事实不符，请联系长河编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

三维扫描检测在汽车制造中的应用

三维扫描检测在汽车制造中的应用

三维扫描，通过先进三维扫描技术获取产品和物体的形面三维数据，建立实物的三维图档，满足各种实物3D模型数据获取、三维数字化展示、3D多媒体开发、三维数字化存档、逆向设计、产品开发、直接3D打印制造或辅助加工制造等一系列的应用。 三维扫描…
阅读更多...
应用案例 | 船舶海洋： 水下无人航行器数字样机功能模型构建

应用案例 | 船舶海洋： 水下无人航行器数字样机功能模型构建

水下无人航行器数字样机功能模型构建 一、项目背景 为响应水下装备系统研制数字化转型及装备系统数字样机建设的需要，以某型号水下无人航行器（Underwater Unmanned Vehicle，UUV）为例，构建UUV数字样机1.0功能模型。针对…
阅读更多...
【unity小技巧】分享vscode如何开启unity断点调试模式，并进行unity断点调试（2024年最新的方法，实测有效）

【unity小技巧】分享vscode如何开启unity断点调试模式，并进行unity断点调试（2024年最新的方法，实测有效）

文章目录 前言一、前置条件1、已安装Visual Studio Code，并且unity首选项>外部工具>外部脚本编辑器选择为Visual Studio Code [版本号]，2、在Visual Studio Code扩展中搜索Unity，并安装3、同时注意这个插件下面的描述，需要根…
阅读更多...
P4645 [COCI2006-2007#3] BICIKLI(Tarjan+topsort求到某点的方案数）

P4645 [COCI2006-2007#3] BICIKLI(Tarjan+topsort求到某点的方案数）

P4645 [COCI2006-2007#3] BICIKLI - 洛谷 | 计算机科学教育新生态 思路： 我们考虑输出inf的情况，可以发现当从1出发到2经过的任意一个点处于一个环内时，路径条数是无穷多的。 有向图上从s到t的经过点，就是从s出发所能经过的所有…
阅读更多...
基于eFramework车控车设中间件介绍

基于eFramework车控车设中间件介绍

车设的发展，起源于汽车工业萌芽之初，经历了机械式操作的原始粗犷，到电子式调控技术的巨大飞跃，到如今智能化座舱普及，远程车控已然成为汽车标配，车设功能选项也呈现出爆发式增长，渐趋多元繁杂。…
阅读更多...
【AI系统】模型压缩基本介绍

【AI系统】模型压缩基本介绍

基本介绍 随着神经网络模型的复杂性和规模不断增加，模型对存储空间和计算资源的需求越来越多，使得部署和运行成本显著上升。模型压缩的目标是通过减少模型的存储空间、减少计算量或提高模型的计算效率，从而在保持模型性能的同时，…
阅读更多...
解决Unity编辑器Inspector视图中文注释乱码

解决Unity编辑器Inspector视图中文注释乱码

1.问题介绍 新创建一个脚本，用VS打开编辑，增加一行中文注释保存，在Unity中找到该脚本并选中，Inspector视图中预览的显示内容，该中文注释显示为乱码，如下图所示： 2.图示解决步骤 按上述步骤操作…
阅读更多...
Java项目实战II基于微信小程序的旅游社交平台（开发文档+数据库+源码）

Java项目实战II基于微信小程序的旅游社交平台（开发文档+数据库+源码）

目录 一、前言 二、技术介绍 三、系统实现 四、核心代码 五、源码获取 全栈码农以及毕业设计实战开发，CSDN平台Java领域新星创作者，专注于大学生项目实战开发、讲解和毕业答疑辅导。 一、前言 随着移动互联网的迅猛发展，旅游已经成为人…
阅读更多...
【错误记录】Android Studio 开发环境内存占用过多 ( 记录内存使用情况 )

【错误记录】Android Studio 开发环境内存占用过多 ( 记录内存使用情况 )

文章目录 一、报错信息二、AS 内存记录分析 一、报错信息 使用 Android Studio 一段时间后 , 内存爆了 , 占用了 10G 的内存 ; 二、AS 内存记录分析 AS 刚启动时 , 只占 2014M 内存 ; 编译运行程序后 , 内存变为 2800M 左右 ; 设置显示的运行程序对应的日志 , 占用内存 就会稳定…
阅读更多...
开发类似的同款小程序系统制作流程

开发类似的同款小程序系统制作流程

很多老板想要开发一款和别人家类似的同款小程序系统，但是不知道该怎么开发制作，本文就为大家详细介绍一下开发类似的同款小程序的流程为大家做参考。 一、前期准备找到对标小程序：首先，需要找到你想要模仿的同款小程序&#xff0…
阅读更多...
三轴云台之光学变焦功能篇

三轴云台之光学变焦功能篇

三轴云台的光学变焦功能是其重要的性能特点之一，该功能允许用户在不改变相机与拍摄对象之间物理距离的情况下，通过调整镜头的焦距来改变拍摄对象的放大倍数或视野范围。 一、光学变焦的原理 光学变焦是通过改变镜头内部的透镜组合来改变焦距的。当镜头中…
阅读更多...
android WebRtc 无法推流以及拉流有视频无声音问题

android WebRtc 无法推流以及拉流有视频无声音问题

最近在开发使用WebRtc进行视频通话和语音通话，我使用的设备是MTK的手机，期间后台的技术人员几乎没法提供任何帮助，只有接口和测试的web端，有遇到不能推流。推流成功网页端有画面有声音，但是安卓端有画面，没…
阅读更多...
锻造船用发动机动力系统，铸强船舶“心脏”

锻造船用发动机动力系统，铸强船舶“心脏”

船舶是海洋、湖泊及河流中重要的水上交通工具，不仅能够促进海上经济的发展，还能够保卫国家的制海权。船舶动力装置，也就是船舶的核心动力源——船用发动机动力系统对船舶的重要作用不言自明，关系到船舶的性能质量，能够…
阅读更多...
uniapp 自定义导航栏增加首页按钮，仿微信小程序操作胶囊

uniapp 自定义导航栏增加首页按钮，仿微信小程序操作胶囊

实现效果如图 抽成组件navbar.vue&#xff0c;放入分包 <template><view class"header-nav-box":style"{height:Props.imgShow?:statusBarHeightpx,background:Props.imgShow?:Props.bgColor||#ffffff;}"><!-- 是否使用图片背景 false…
阅读更多...
WPF中的VisualState(视觉状态)

WPF中的VisualState(视觉状态)

以前在设置控件样式或自定义控件时&#xff0c;都是使用触发器来进行样式更改。触发器可以在属性值发生更改时启动操作。 像这样&#xff1a; <Style TargetType"ListBoxItem"><Setter Property"Opacity" Value"0.5" /><Setter …
阅读更多...
Java 实现手机号码归属地查询

Java 实现手机号码归属地查询

1.pom坐标 <dependency><groupId>com.googlecode.libphonenumber</groupId><artifactId>geocoder</artifactId><version>2.205</version></dependency> 2.代码 package test;import com.alibaba.excel.util.StringUtils; im…
阅读更多...
C 进阶 — 数据在内存中的存储

C 进阶 — 数据在内存中的存储

C 进阶 — 数据在内存中的存储 主要内容 1、数据类型详细介绍 2、整形在内存中的存储&#xff1a;原码、反码、补码 3、大小端字节序介绍及判断 4、浮点型在内存中的存储解析 一 数据类型介绍 基本内置类型 char //字符数据类型 1 short //短整型 …
阅读更多...
工作：SolidWorks从3D文件导出2D的DWG或DXF类型文件方法

工作：SolidWorks从3D文件导出2D的DWG或DXF类型文件方法

工作&#xff1a;SolidWorks从3D文件导出2D的DWG或DXF类型文件方法 SolidWorks从3D文件导出2D的DWG或2D DXF类型文件方法&#xff08;一&#xff09;打开3D文件&#xff08;二&#xff09;从装配体到工程图&#xff08;三&#xff09;拖出想要的角度的图型&#xff08;四&#…
阅读更多...
Linux-PWM驱动实验

Linux-PWM驱动实验

在裸机篇我们已经学习过了如何使用 I.MX6ULL 的 PWM 外设来实现 LCD 的背光调节&#xff0c;其实在 Linux 的 LCD 驱动实验我们也提到过 I.MX6ULL 的 PWM 背光调节&#xff0c;但是并没有专门的去讲解 PWM 部分&#xff0c;本章我们就来学习一下 Linux 下的 PWM 驱动开发。 PWM…
阅读更多...
Mysql学习-Mysql查询(1)

Mysql学习-Mysql查询(1)

1.基本查询&#xff08;SELECT&#xff09; SELECT语句基本格式&#xff1a; SELECT {*|<字段列表>} [ FROM<表1>&#xff0c;<表2>.. [WHERE <表达式> [GROUP BY<group by definition>] [HAVING <expression>[{<operator><exp…
阅读更多...
最新文章
推荐文章

Copyright @ 2022~2023