Veo Videos Generation API 对接说明

本文介绍了如何对接 Veo Videos Generation API，通过输入自定义参数生成Veo官方视频。

下面将详细阐述 Veo Videos Generation API 的对接流程。

申请流程

使用 API 前，需前往 Veo Videos Generation API 页面申请服务。进入页面后，点击「Acquire」按钮，如下图所示：

如果尚未登录或注册，将自动跳转至登录页面，邀请您注册或登录。登录后将返回到当前页面。

首次申请时会获得免费额度，可免费使用该 API。

基本使用

基本使用方式为输入提示词 prompt、生成行为 action、首尾帧参考图片数组 image_urls 及模型 model 来获取处理结果。需首先传递 action 字段，值为 text2video，此字段包含三种行为：文生视频（text2video）、图生视频（image2video）、获取1080p视频（get_1080p）。接着需输入模型 model，当前可选择 veo2、veo2-fast、veo3 和 veo3-fast，具体内容如下：

可以看到设置了请求头部，包括：

  • accept：希望收到的响应格式，此处填写为 application/json，即 JSON 格式。
  • authorization：调用 API 需要的密钥，申请后可以直接下拉选择。

同时设置了请求主体，包括：

  • model：生成视频时使用的模型，主要有 veo2、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-e1f7-4b68-aa8c-463f6b748d11", "trace_id": "9906dac0-1516-41dc-9fe3-067ca1ba8269", "data": [ { "id": "253eedc47f1c4eb2a370ed2312168f4b", "video_url": "https://platform.cdn.acedata.cloud/veo/dd01fc69-e1f7-4b68-aa8c-463f6b748d11.mp4", "created_at": "2025-07-25 16:07:43", "complete_at": "2025-07-25 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：生成视频的模型，主要有 veo2、veo2-fast、veo3 和 veo3-fast。
  • image_urls：必须上传的首尾帧参考图片链接。
  • prompt：提示词。

填写示例如下：

填写完成后自动生成的代码如下：

对应的 Python 代码为：

```python import requests

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

headers = { "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, json=payload, headers=headers) print(response.text) ```

点击运行，可以得到如下结果：

json { "success": true, "task_id": "98e309f3-35bc-438d-8cb3-4015fc864b87", "trace_id": "8bc68066-36de-41ef-ae5e-b7d61ff6aee8", "data": [ { "id": "59f12222b1fa4fbe9331ff2400ad1583", "video_url": "https://platform.cdn.acedata.cloud/veo/98e309f3-35bc-438d-8cb3-4015fc864b87.mp4", "created_at": "2025-07-25 16:13:07", "complete_at": "2025-07-25 16:16:12", "state": "succeeded" } ] }

结果与前文一致，从而实现图生视频功能。

获取1080p视频功能

如需对已生成的视频获取1080p，可将参数 action 设置为 get_1080p，并输入需要获取1080p的视频 ID，视频 ID 可通过基本使用获取，如图所示：

此时视频的 ID 为：

json "id": "59f12222b1fa4fbe9331ff2400ad1583"

注意，此处的 video_id 是生成后视频的 ID，若不知如何生成视频，请参考前文基本使用生成视频。

接下来需填写提示词以自定义生成视频，可指定如下内容：

  • model：生成视频的模型，主要有 veo2、veo2-fast、veo3 和 veo3-fast。
  • video_id：参考的视频 ID，用于获取1080p视频。

填写示例如下：

填写完成后自动生成的代码如下：

点击运行后将得到如下结果：

json { "success": true, "task_id": "47a51cfe-2e24-4aba-93b3-546c2dc52984", "trace_id": "a8922eec-6f50-4f77-8104-00ded071d59d", "data": [ { "id": "59f12222b1fa4fbe9331ff2400ad1583", "video_url": "https://platform.cdn.acedata.cloud/veo/47a51cfe-2e24-4aba-93b3-546c2dc52984.mp4", "created_at": "2025-07-25 16:13:07", "complete_at": "2025-07-25 16:16:12", "state": "succeeded" } ] }

结果与前文一致，从而实现获取1080p视频功能。

指定视频尺寸生成

如需生成自定义尺寸的Veo视频，可将参数 aspect_ratio 设置为所需尺寸，接下来需填写提示词以自定义生成视频，可指定如下内容：

  • model：生成视频的模型，主要有 veo2、veo2-fast、veo3 和 veo3-fast。
  • aspect_ratio：视频尺寸，支持 16:9、3:4、4:3、1:1，默认值为 16:9。
  • translation：是否启用提示词自动翻译，默认值为 false。

填写示例如下：

填写完成后将自动生成代码如下：

点击运行后将得到如下结果：

json { "success": true, "task_id": "d2b93290-ab0e-4d20-ae45-60c062a32687", "trace_id": "9834e64d-c8fe-43ae-8114-ee2b5f93d886", "data": [ { "id": "fc667e7d3b8f44beaa61a3c339af0e50", "video_url": "https://platform.cdn.acedata.cloud/veo/d2b93290-ab0e-4d20-ae45-60c062a32687.mp4", "created_at": "2025-08-24 20:09:06", "complete_at": "2025-08-24 20:10:45", "state": "succeeded" } ] }

结果与前文一致，从而实现指定尺寸生成视频的功能。

异步回调

鉴于 Veo Videos Generation API 的生成时间较长，通常需要 1-2 分钟。如果 API 长时间没有响应，HTTP 请求将保持连接，导致系统资源消耗增加，因此本 API 提供了异步回调支持。

整体流程为：客户端发起请求时，额外指定 callback_url 字段。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-9480-8ec9b42137dc。

接下来，设置字段 callback_url 为上述 Webhook URL，并填写相应参数，具体内容如图所示：

点击运行，将立即得到如下结果：

json { "task_id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed" }

稍等片刻，在 https://webhook.site/aed5cd28-f8aa-4dca-9480-8ec9b42137dc 可以观察生成视频结果，如图所示：

内容如下：

json { "success": true, "task_id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed", "trace_id": "d1d53c04-58c5-4c40-bb63-f00188540e56", "data": [ { "id": "2f43ceed37944b4d836e1a1899dad0a1", "video_url": "https://platform.cdn.acedata.cloud/veo/1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed.mp4", "created_at": "2025-07-25 17:19:20", "complete_at": "2025-07-25 17:21:45", "state": "succeeded" } ] }

结果中带有一个 task_id 字段，其他字段与前文类似，通过此字段可实现任务关联。

错误处理

调用 API 时遇到错误，API 将返回相应的错误代码与信息，如：

  • 400 token_mismatched：错误请求，可能因缺失或无效参数造成。
  • 400 api_not_implemented：错误请求，可能因缺失或无效参数造成。
  • 401 invalid_token：未经授权，无效或缺失授权令牌。
  • 429 too_many_requests：请求过多，超出速率限制。
  • 500 api_error：内部服务器错误，服务器出现问题。

错误响应示例

json { "success": false, "error": { "code": "api_error", "message": "fetch failed" }, "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89" }

结论

通过本文档，您已了解如何使用 Veo Videos Generation API，通过输入提示词及首帧参考图片生成视频。希望本文档能够帮助您更好地对接与使用该 API。如有任何疑问，请随时联系我们的技术支持团队。

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

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

相关文章

YOLO 目标检测：YOLOv3网络结构、特征输出、FPN、多尺度预测

YOLO 目标检测：YOLOv3网络结构、特征输出、FPN、多尺度预测

文章目录一、YOLOV31、网络结构1.1 整体结构1.2 主干网络1.3 特征输出1.4 特征融合FPN（Feature Pyramid Networks）FPN 融合上采样融合2、多尺度预测3、损失函数4、性能对比一、YOLOV3 YOLOv3（You Only Look Once v3）是YOLO系列中…
阅读更多...
【GIS图像处理】有哪些SOTA方法可以用于将1.5米分辨率遥感图像超分辨率至0.8米精度的？

【GIS图像处理】有哪些SOTA方法可以用于将1.5米分辨率遥感图像超分辨率至0.8米精度的？

针对将1.5米分辨率遥感图像超分辨率至0.8米的需求，当前主流方法可分为以下几类，结合最新研究进展和实际应用场景，具体技术方案及SOTA方法如下： 一、基于Transformer的高效建模 1. Top-k标记选择Transformer（TTST） 核心机制：通过动态选择前k个关键标记（token），消除冗…
阅读更多...
【电力电子】逆变器控制策略：PQ Droop下垂控制、电压电流双环控制与SPWM调制

【电力电子】逆变器控制策略：PQ Droop下垂控制、电压电流双环控制与SPWM调制

逆变器中的 PQ Droop 控制。 1. PQ Droop 控制的定义 PQ Droop（有时也称为功率下垂控制，Power Droop Control）是微电网、并联系统或逆变器并网运行中常用的一种分布式功率控制方法。 P-Droop（有功下垂）：通过调节逆变器输出频率与有功功率之间的关系实现功率分配。 Q-Dro…
阅读更多...
【LeetCode 热题 100】5. 最长回文子串——中心扩散法

【LeetCode 热题 100】5. 最长回文子串——中心扩散法

Problem: 5. 最长回文子串 文章目录整体思路完整代码时空复杂度时间复杂度：O(N^2)空间复杂度：O(1)整体思路 这段代码旨在解决经典的 “最长回文子串” (Longest Palindromic Substring) 问题。问题要求在一个给定的字符串 S 中，找到一个最长…
阅读更多...
六、练习3：Gitee平台操作

六、练习3：Gitee平台操作

练习3：Gitee平台操作 练习目标 掌握Gitee平台的基本操作，包括创建仓库、推送代码、团队协作等。 练习步骤 步骤1：Gitee账号准备 访问 gitee.com注册账号（如果还没有）登录Gitee 步骤2：配置SSH密钥 # …
阅读更多...
Git软件版本控制

Git软件版本控制

软件版本控制作用：软件源码版本管理、多人协作开发、版本多分支开发、代码回滚（回退）等功能。集中式版本控制：将代码仓库放在一台服务器上，开发时要依赖这台服务器。优点：简单、方便管理、适合中小型项目缺…
阅读更多...
生产环境Spark Structured Streaming实时数据处理应用实践分享

生产环境Spark Structured Streaming实时数据处理应用实践分享

生产环境Spark Structured Streaming实时数据处理应用实践分享 一、业务场景描述 我们所在的电商平台需要实时监控用户行为数据（如点击、下单、支付等），基于事件级别的流式数据进行实时统计、会话聚合、漏斗分析，并将结果推送到Da…
阅读更多...
海康相机开发---HCNetSDK

海康相机开发---HCNetSDK

HCNetSDK（Hikvision Network Software Development Kit）是海康威视专为旗下安防监控设备打造的二次开发工具包，是连接上层应用与海康设备的核心桥梁。其封装了设备底层通信协议（包括私有协议与部分标准协议）&#xff0…
阅读更多...
构建无广告私人图书馆Reader与cpolar让电子书库随身携带

构建无广告私人图书馆Reader与cpolar让电子书库随身携带

文章目录前言：告别书荒，拯救灵魂的“摸鱼神器”1、关于Reader：小而美的开源在线阅读器2、Docker部署3、简单使用reader和添加书源4.群晖安装Cpolar工具5.创建reader阅读器的公网地址6.配置固定公网地址前言：告别书荒，拯…
阅读更多...
amd cpu是x86架构吗

amd cpu是x86架构吗

是的，AMD CPU属于x86架构‌，其64位扩展（x86-64）最初由AMD设计并成为行业标准。‌ ‌AMD与x86架构的关系‌ ‌技术渊源‌：AMD自1976年起通过技术授权成为x86架构的合法制造商，与英特尔共同主导x86市场。2003…
阅读更多...
vercel上线资源无法加载

vercel上线资源无法加载

背景：在本地跑开发服务器没问题，但是部署到 vercel 上就有问题上一次出现类似问题是在更新游戏引擎方法后本地可以跑但是上线没有成功，当时是因为 runner.html 是在部署时通过脚本从远端仓库拉取的，所以解决方案：1.更新…
阅读更多...
Node.js 的模块化规范是什么？CommonJS 和 ES6 模块有什么区别？

Node.js 的模块化规范是什么？CommonJS 和 ES6 模块有什么区别？

目录 一、为什么需要模块化？ 二、Node.js 的模块化规范 三、CommonJS 模块化 1. 基本语法 2. 特点 3. 缺点 四、ES6 模块（ESM） 1. 基本语法 2. 特点 3. 在 Node.js 中的使用 五、CommonJS 和 ES6 模块的区别 六、实际开发中的选择…
阅读更多...
设计模式：代理模式（Proxy Pattern）

设计模式：代理模式（Proxy Pattern）

文章目录一、代理模式的定义二、实例分析三、示例代码一、代理模式的定义 代理模式是一种结构型设计模式，它为某个对象提供一个代理或占位符，以控制对这个对象的访问。简单来说代理对象在客户端和目标对象之间起到中介作用，客户端并不会直接操…
阅读更多...
数据类型序列化-封装

数据类型序列化-封装

/// <summary> /// 定义泛型接口 /// </summary> /// <typeparam name"T">T</typeparam> public interface ISettingValue<T> {/// <summary>/// value/// </summary>T DoubleValue { get; }/// <summary>/// key//…
阅读更多...
PitVis-2023挑战赛：内镜下垂体瘤手术视频中的手术流程识别|文献速递-深度学习人工智能医疗图像

PitVis-2023挑战赛：内镜下垂体瘤手术视频中的手术流程识别|文献速递-深度学习人工智能医疗图像

Title题目PitVis-2023 challenge: Workflow recognition in videos of endoscopic pituitary surgeryPitVis-2023挑战赛&#xff1a;内镜下垂体瘤手术视频中的手术流程识别01文献速递介绍内镜视觉挑战赛与PitVis-2023挑战赛背景及核心内容 “内镜视觉&#xff08;EndoVis&#…
阅读更多...
2025年8月个人工作生活总结

2025年8月个人工作生活总结

本文为 2025年8月工作生活总结。研发编码 无处不在的AI 现在很多地方都在推AI&#xff0c;广西的人工智能走在前列&#xff0c;要赋能各行各业。至于我&#xff0c;主要就是在写点代码&#xff0c;写点交差的文档。其实现在我已经有点分析哪些代码哪些文字是AI写的了。我工作用…
阅读更多...
Dubbo常见面试题

Dubbo常见面试题

1、默认使用的是什么通信框架&#xff0c;还有别的选择吗? 默认也推荐使用netty框架&#xff0c;还有mina。 2、服务调用是阻塞的吗&#xff1f; 默认是阻塞的&#xff0c;可以异步调用&#xff0c;没有返回值的可以这么做。 3、一般使用什么注册中心&#xff1f;还有别的…
阅读更多...
简单的加密算法

简单的加密算法

// 加密函数&#xff08;32位版本&#xff09; //这里的 data 是ID&#xff0c; dword encrypt(dword data, dword key, int shift) {data ^ key; // 第一步&#xff1a;异或混淆// 循环左移&#xff08;shift范围1-31&#xff09;return (data << sh…
阅读更多...
升级的MS9125S USB投屏控制芯片（VGAHD输出）

升级的MS9125S USB投屏控制芯片（VGAHD输出）

MS9125S是一款USB单芯片投屏器&#xff0c;内部集成了USB 2.0控制器和数据收发模块、视频DAC、HD接口和音视频处理模块&#xff0c;支持压缩视频传输。MS9125S可以通过USB接口显示或者扩展PC、智能手机、平板电脑的显示信息到更大尺寸的显示设备上&#xff0c;支持VGA和HD视频接…
阅读更多...
求欧拉回路：Hierholzer算法图解模拟

求欧拉回路：Hierholzer算法图解模拟

代码模板&#xff1a;List<Integer> resultList new ArrayList<>();List<Integer> hierholzer() {dfs(0);resultList.add(0);// 数组反转Collections.reverse(resultList);return resultList; }void dfs(int start) {for(int end : G[start]) {if(!vis[star…
阅读更多...
最新文章

Copyright @ 2022~2023