Luma AI,让你的视频像电影一样精彩!附带使用教程

news2024/11/15 11:33:52

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 分钟,结果如下:

{
  "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:生成视频的关键词内容。

填写样例如下:

填写完毕之后自动生成了代码如下:
对应的代码:

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.acedata.cloud/r9vsv9.png",
    "action": "generate",
    "prompt": "Astronauts shuttle from space to volcano"
}

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

得到的结果如下:

{
  "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
}

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

尾帧

填写样例如下:

最后得出如下结果:

{
  "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_idvideo_url 是生成后视频的ID和视频链接,如果你不知道如何生成视频,可以参考上文的基本使用来生成视频。

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

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

填写样例如下:

填写完毕之后自动生成了代码如下:
对应的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)

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

{
  "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
}

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

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

在这里插入图片描述

运行后得到了如下结果:

{
  "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
}

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

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

尾帧

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

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

{
  "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,如图所示:

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

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

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

内容如下:

{
    "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.coloradmin.cn/o/2085232.html

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈,一经查实,立即删除!

相关文章

tomcat实验

Tomcat 服务器是一个免费的开放源代码的Web 应用服务器,属于轻量级应用服务器,在中小型系统和并发访问用户不是很多的场合下被普遍使用,Tomcat 具有处理HTML页面的功能,它还是一个Servlet和JSP容器。 下载文件 安装javajdk 解压 …

ComfyUI基础操作教学!小白入门必看!

在我们打开comfyui后会面对一堆节点,那么这些节点都是什么意思呢?今天跟着小元老师来学习一下吧~ 一、拆解文生图基本工作流 这个是Comfyui默认的文生图工作流它的基本逻辑是: 条件输入板块——潜空间——像素空间 01 条件输入模…

AiThinkerIDE_V1.5.2工程随意移动地方,路径不能有空格

路径不能有空格,例如usr_sdk不能改为usr sdk IDF_PATH: ${workspace_loc:/AiThinkerProjectForESP}${workspace_loc:/AiThinkerProjectForESP}/examples/get-started/hello_world

2024年入职_转行网络安全,该如何规划呢?

前言 前段时间,知名机构麦可思研究院发布了 《2023年中国本科生就业报告》,其中详细列出近五年的本科绿牌专业,其中,信息安全位列第一。 网络安全前景 对于网络安全的发展与就业前景,想必无需我多言,作为…

C#中的批量引用已有的NuGet包

引言 小伙伴们有没有遇到过一个问题,就是我有一个类库A引用了很多NuGet包,但是到B类库中也需要使用,但是不想一个一个引用,很麻烦,所以我教大家一招,直接复制NuGet包: 第一步: 找…

【开发实战】QT5 + 深度学习六大应用案例

点击这里,即可一键获取六大案例源码与相关资料 QT5 OpenCV4.8 QT5 OpenCV4.8 开发与配置环境搭建,请看博客文章 QT5 OpenCV4 开发环境配置应用演示 深度学习模型部署 深度学习模型部署有很多成熟的框架,当前经常使用的深度学习模型推理…

linux 上传文件报错 -bash: rz:command not found

linux 上传文件报错 -bash: rz:command not found 新创建的纯净虚拟机无法上传文件安装lrzsz 新创建的纯净虚拟机无法上传文件 这个错误表明系统中没有安装 rz(上传文件工具)命令。 如果是在 CentOS 或 Red Hat 等基于 RPM 的系统上,可以使用…

基于RFID光触发标签的光交箱哑资源管理优化方案

当今数字化高速发展的时代,政企单位对通信服务的质量和可靠性提出了越来越高的要求。光交箱作为通信网络中的关键节点,其哑资源的有效管理对于保障通信的顺畅至关重要。然而,传统的管理方式在面对日益复杂的通信需求时,逐渐暴露出…

PHP多功能投票系统小程序源码社群决策与趣味互动新潮流

🌟【引领社群新风尚,一键决策更轻松】🌟 你还在为社群活动意见不合而烦恼吗?多功能投票小程序来拯救你的选择困难症!无论是团队项目方案、周末出游地点,还是晚餐吃什么的小纠结,只需轻轻一点&a…

蓝牙语音遥控器方案

在智能家居的时代,科技正在改变我们的生活方式。蓝牙语音遥控器,作为智能家居的关键组成部分,正在重新定义用户与设备之间的互动方式。用户对着蓝牙语音遥控器,只要轻说一句话就可以搞定很多复杂的遥控操作,使用非常方…

Flask+LayUI开发手记(五):树型表格实现数据展示与编辑

说起来,树型表格treeTable绝对是后端程序员的巨大福利。要知道,在系统编程中,有父子节点关系的数据真是太多了,随便想一下就可以举出很多例子,比如权限、栏目、机构、产品、科目、货币、行业诸般等等,其实只…

国密起步4:GmSSL3生成证书并使用tls(SM2、SSL)

初级代码游戏的专栏介绍与文章目录-CSDN博客 我的github:codetoys,所有代码都将会位于ctfc库中。已经放入库中我会指出在库中的位置。 这些代码大部分以Linux为目标但部分代码是纯C的,可以在任何平台上使用。 此文介绍如何使用gmssl的tls示…

RCS plot 包内置数据集使用时报错,如何解决?

🏆本文收录于《CSDN问答解惑-专业版》专栏,主要记录项目实战过程中的Bug之前因后果及提供真实有效的解决方案,希望能够助你一臂之力,帮你早日登顶实现财富自由🚀;同时,欢迎大家关注&&收…

【爬虫软件】YouTube评论采集工具

我用Python开发的油管评论批量采集软件。 软件界面: 采集结果: 演示视频: https://www.bilibili.com/video/BV1Ny411z7Wk 完整讲解: https://www.bilibili.com/read/cv35334276

Python进阶01-面向对象基础

零、文章目录 Python进阶01-面向对象基础 1、面向对象编程思想 (1)编程思想是什么 所谓的编程思想,就是人们利用计算机来解决实际问题的一种思维方式。常见的编程思想有面向过程和面向对象,很多计算机语言的语法各不相同&…

OpenHarmony南向开发:分布式软总线-softbus_tool使用规范

oftbus_tool 是 OpenHarmony 分布式软总线 API 调用测试工具,文件结构如下图所示。 softbus_tool 能够将软总线 interfaces 目录下的一些常用接口集中起来,供设备间搭建一些场景时使用(比如设备绑定、BR 组网,BLE 组网&#xff0…

oracle的BITAND()函数用法

BITAND函数是计算两个数据的按位与 如下: 0010 0101 的按位与结果是0000 转为2进制就是0 0010 0011 的按位与结果是0010 转为2进制就是2

linux本地库迁移到阿里云云redis

背景 领导要我把另外一个不同账号的云redis进行同步 想法 阿里云不能直接备份还原redis,需要把备份文件先给搞到本地redis,然后本地redis进行同步到云redis 大概的逻辑是这样 实操 我这里下载的版本是4.0.2,文件如下: redis-shake-linux-amd64.tar.gz github下…

独立站除了Shopify还有什么?

国外电商平台仅占40-50%的市场份额。独立网站具有巨大的潜力。通过建立独立的跨境电商网站,您可以拥有自己的品牌销售体系。然而,对于很多平台卖家来说,建站可能并不是一件容易的事。在构建网站之前需要考虑几个问题,以及如何选择…

如何用wireshark分析找出url接口和param参数???

🏆本文收录于《CSDN问答解惑-专业版》专栏,主要记录项目实战过程中的Bug之前因后果及提供真实有效的解决方案,希望能够助你一臂之力,帮你早日登顶实现财富自由🚀;同时,欢迎大家关注&&收…