网站在线咨询代码,linkcat wordpress,绥中做网站公司,w3c网站代码标准规范Luma 视频生成 API 对接说明
随着 AI 的应用变广#xff0c;各类 AI 程序已逐渐普及。AI 已逐渐深入到人们的工作生活方方面面。而 AI 涉及的行业也越来越多#xff0c;从最初的写作#xff0c;到医疗教育#xff0c;再到现在的视频。
Luma 是一个专业高质量的视频生成平…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否则为 falsetask_id此处视频生成任务的唯一IDvideo_id此处视频生成任务产生的视频唯一IDprompt此处视频生成任务的关键词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, jsonpayload, headersheaders) 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, jsonpayload, headersheaders) 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 字段其他的字段都和上文类似通过该字段即可实现任务的关联。
