核心内容摘要
本地AI大模型+200+数据源，小白也能5分钟搞定！
Veo 是 Google 最近出的一个非常强大的模型很多人都用它来生成各种各样的视频。
但是官方的价格还是很贵的这里介绍一款稳定的 Veo API稳定性高帮你节省成本的同时助力您的创作本文接下来将介绍来自 Ace Data Cloud 的 Veo Videos Generation API 对接说明它是可以通过输入自定义参数来生成Veo官方的视频。
申请流程要使用 API需要先到 Veo Videos Generation API https://platform.acedata.cloud/documents/veo-videos 对应页面申请对应的服务进入页面之后点击「Acquire」按钮如图所示如果你尚未登录或注册会自动跳转到登录页面邀请您来注册和登录登录注册之后会自动返回当前页面。
在首次申请时会有免费额度赠送可以免费使用该 API。
基本使用首先先了解下基本的使用方式就是输入提示词prompt、 生成行为action、首尾帧参考图片数组image_urls以及模型model便可获得处理后的结果首先需要简单地传递一个action字段它的值为text2video它主要包含三种行为文生视频text2video、图生视频image2video、获取1080p视频get_1080p然后我们还需要输入模型model目前主要有veo
veo2-fast、veo3和veo3-fast模型具体的内容如下可以看到这里我们设置了 Request Headers包括accept想要接收怎样格式的响应结果这里填写为application/json即 JSON 格式。
authorization调用 API 的密钥申请之后可以直接下拉选择。
另外设置了 Request Body包括model生成视频的模型主要有veo
veo2-fast、veo3和veo3-fast模型。
action此次视频生成任务的行为主要包含三种行为分别为文生视频text2video、图生视频image2video、获取1080p视频get_1080p。
image_urls当选择图生视频行为image2video就必须需要上传的首尾帧参考图片链接。
prompt提示词。
callback_url需要回调结果的URL。
选择之后可以发现右侧也生成了对应代码如图所示点击「Try」按钮即可进行测试如上图所示这里我们就得到了如下结果json { success: true, task_id: dd01fc69-e1f
b68-aa8c-463f6b748d11, trace_id: 9906dac
dc-9fe
ca1ba8269, data: [ { id: 253eedc47f1c4eb2a370ed2312168f4b, video_url: https://platform.cdn.acedata.cloud/veo/dd01fc69-e1f
b68-aa8c-463f6b748d
mp4, created_at:
16:07:43, complete_at:
16:10:28, state: succeeded } ] }返回结果一共有多个字段介绍如下success此时视频生成任务的状态情况。
task_id此时视频生成任务ID。
data此时视频生成任务的结果。
id此时视频生成任务的视频ID。
video_url此时视频生成任务的视频链接。
created_at此时视频生成任务的创建时间。
complete_at此时视频生成任务的完成时间。
state此时视频生成任务的状态。
可以看到我们得到了满意的视频信息我们只需要根据结果中data的视频链接地址获取生成的Veo视频即可。
另外如果想生成对应的对接代码可以直接复制生成例如 CURL 的代码如下shell curl -X POST https://api.acedata.cloud/veo/videos \ -H accept: application/json \ -H authorization: Bearer {token} \ -H content-type: application/json \ -d { action: text2video, model: veo2, prompt: White ceramic coffee mug on glossy marble countertop with morning window light. Camera slowly rotates 360 degrees around the mug, pausing briefly at the handle. }图生视频功能如果想根据首尾帧图片进行生成视频的话可以将参数action设置为image2video并且输入首尾帧图片链接数组image_urls。
接下来我们要必须填下一步需要扩展的提示词来自定义生成视频就可以指定如下内容model生成视频的模型主要有veo
veo2-fast、veo3和veo3-fast。
image_urls当选择图生视频行为image2video就必须需要上传的首尾帧参考图片链接。
prompt提示词。
填写样例如下填写完毕之后自动生成了代码如下对应的 Python 代码python import requestsurl https://api.acedata.cloud/veo/videosheaders { accept: application/json, authorization: Bearer {token}, content-type: application/json }payload { action: image2video, model: veo2, prompt: Let it dance, image_urls: [https://cdn.acedata.cloud/7p1jhy.png] }response requests.post(url, jsonpayload, headersheaders) print(response.text) 点击运行可以发现会得到一个结果如下json { success: true, task_id: 98e309f
bc-438d-8cb
fc864b87, trace_id: 8bc
de-41ef-ae5e-b7d61ff6aee8, data: [ { id: 59f12222b1fa4fbe9331ff2400ad1583, video_url: https://platform.cdn.acedata.cloud/veo/98e309f
bc-438d-8cb
fc864b
mp4, created_at:
16:13:07, complete_at:
16:16:12, state: succeeded } ] }可以看出结果内容与上文的是一致的这也就实现视频的图生视频功能。
获取1080p视频功能如果想对已经生成的Veo视频获取1080p的话可以将参数action设置为get_1080p并且输入需要获取1080p的视频的 ID视频 ID 的获取是根据基本使用来获取如下图所示这时候可以看到视频的 ID 为json id: 59f12222b1fa4fbe9331ff2400ad1583注意这里的视频中video_id是生成后视频的 ID如果你不知道如何生成视频可以参考上文的基本使用来生成视频。
接下来我们要必须填下一步需要扩展的提示词来自定义生成视频就可以指定如下内容model生成视频的模型主要有veo
veo2-fast、veo3和veo3-fast。
video_id参考的视频ID用于获取1080p的视频。
填写样例如下填写完毕之后自动生成了代码如下点击运行可以发现会得到一个结果如下json { success: true, task_id: 47a51cfe-2e
aba-93b
c2dc52984, trace_id: a8922eec-6f
f
ded071d59d, data: [ { id: 59f12222b1fa4fbe9331ff2400ad1583, video_url: https://platform.cdn.acedata.cloud/veo/47a51cfe-2e
aba-93b
c2dc
mp4, created_at:
16:13:07, complete_at:
16:16:12, state: succeeded } ] }可以看出结果内容与上文的是一致的这也就实现视频的获取1080p视频功能。
指定视频尺寸生成如果想指定生成自定义尺寸的Veo的视频可以将参数aspect_ratio设置为想要的尺寸接下来我们要必须填下一步需要扩展的提示词来自定义生成视频就可以指定如下内容model生成视频的模型主要有veo
veo2-fast、veo3和veo3-fast。
aspect_ratio视频的尺寸大小目前支持16:
16:
3:
4:
1:1默认是16:9。
translation是否开启提示词的自动翻译默认是false。
填写样例如下填写完毕之后自动生成了代码如下点击运行可以发现会得到一个结果如下json { success: true, task_id: d2b93290-ab0e-4d20-ae
c062a32687, trace_id: 9834e64d-c8fe-43ae-8114-ee2b5f93d886, data: [ { id: fc667e7d3b8f44beaa61a3c339af0e50, video_url: https://platform.cdn.acedata.cloud/veo/d2b93290-ab0e-4d20-ae
c062a
mp4, created_at:
20:09:06, complete_at:
20:10:45, state: succeeded } ] }可以看出结果内容与上文的是一致的这也就实现指定尺寸生成视频功能。
异步回调由于 Veo Videos Generation API生成的时间相对较长大约需要
分钟如果 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/aed5cd28-f8aa-4dca-
ec9b42137dc。
接下来我们可以设置字段callback_url为上述 Webhook URL同时填入相应的参数具体的内容如图所示点击运行可以发现会立即得到一个结果如下json { task_id: 1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed }稍等片刻我们可以在https://webhook.site/aed5cd28-f8aa-4dca-
ec9b42137dc上观察到生成视频的结果如图所示内容如下json { success: true, task_id: 1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed, trace_id: d1d53c
c
c40-bb63-f00188540e56, data: [ { id: 2f43ceed37944b4d836e1a1899dad0a1, video_url: https://platform.cdn.acedata.cloud/veo/1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed.mp4, created_at:
17:19:20, complete_at:
17:21:45, state: succeeded } ] }可以看到结果中有一个task_id字段其他的字段都和上文类似通过该字段即可实现任务的关联。
错误处理在调用 API 时如果遇到错误API 会返回相应的错误代码和信息。
例如400 token_mismatchedBad request, possibly due to missing or invalid parameters.400 api_not_implementedBad request, possibly due to missing or invalid parameters.401 invalid_tokenUnauthorized, invalid or missing authorization token.429 too_many_requestsToo many requests, you have exceeded the rate limit.500 api_errorInternal server error, something went wrong on the server.错误响应示例json { success: false, error: { code: api_error, message: fetch failed }, trace_id: 2cf86e
a
e1-ac2f-032c0f2a4e89 }结论通过本文档您已经了解了如何使用 Veo Videos Generation API 可通过输入提示词以及首帧参考图片来生成视频。
希望本文档能帮助您更好地对接和使用该 API。
如有任何问题请随时联系我们的技术支持团队。