Veo3.1 API 快速开始

5分钟内开始使用 Veo3.1 API

欢迎使用 Veo3.1 API！本指南将帮助您快速开始使用我们的高质量 AI 视频生成服务。

概述

Veo3.1 API 是一个强大的 AI 视频生成平台，支持：

文本转视频

通过描述性文本提示生成高质量视频

图片转视频

让静态图片生动起来，创建引人入胜的视频

高清支持

支持生成 1080P 高清视频（16:9 宽高比）

实时回调

任务完成时自动推送结果到您的服务器

第一步：获取 API Key

访问 API Key 管理页面

注册或登录您的账户

生成新的 API Key

安全保存您的 API Key

注意：

请妥善保管您的 API Key，不要在公开代码库中暴露。如果怀疑泄露，请立即重置。

第二步：基本认证

所有 API 请求都需要在请求头中包含您的 API Key：

API 基础地址: https://api.kie.ai

第三步：您的第一个视频生成

文本转视频示例

Node.js

Python

cURL

图片转视频示例

Node.js

Python

cURL

第四步：查询任务状态

视频生成通常需要几分钟时间。您可以通过轮询或回调获取结果。

轮询方式

Node.js

Python

cURL

状态说明

successFlag	说明
0	生成中 - 任务正在处理
1	成功 - 任务已成功完成
2	失败 - 任务生成失败
3	生成失败 - 任务创建成功但生成失败

第五步：获取高清视频（可选）

如果您使用 16:9 宽高比生成视频，可以获取 1080P 高清版本：

Node.js

Python

cURL

注意: 1080P 视频需要额外处理时间，建议在原视频生成完成后等待几分钟再调用此接口。

回调处理（推荐）

相比轮询，回调机制更高效。设置 callBackUrl 参数，任务完成时系统会自动推送结果：

Node.js

Python

完整示例：从生成到下载

Node.js

最佳实践

优化提示词

使用详细且具体的描述

包含动作、场景、风格信息

避免模糊或矛盾的描述

合理选择模型

veo3: 标准模型，质量更高（Veo3.1）

veo3_fast: 快速模型，生成更快（Veo3.1）

处理异常

实现重试机制

处理网络错误和API错误

记录错误日志便于调试

资源管理

及时下载和保存视频

合理控制并发请求数量

监控API使用额度

常见问题

生成需要多长时间？

支持哪些图片格式？

如何获得更好的视频质量？

视频 URL 有有效期吗？

如何处理生成失败？

如何生成超过 8 秒的Veo 3.1视频？

下一步

API 参考

查看完整的 API 参数和响应格式

回调处理

学习如何处理任务完成回调

获取详情

了解如何查询任务状态和结果

如果您在使用过程中遇到任何问题，请联系我们的技术支持：support@kie.ai

Veo3.1 API 快速开始

概述#

第一步：获取 API Key#

第二步：基本认证#

第三步：您的第一个视频生成#

文本转视频示例#

图片转视频示例#

第四步：查询任务状态#

轮询方式#

状态说明#

第五步：获取高清视频（可选）#

回调处理（推荐）#

完整示例：从生成到下载#

最佳实践#

常见问题#

下一步#

概述

第一步：获取 API Key

第二步：基本认证

第三步：您的第一个视频生成

文本转视频示例

图片转视频示例

第四步：查询任务状态

轮询方式

状态说明

第五步：获取高清视频（可选）

回调处理（推荐）

完整示例：从生成到下载

最佳实践

常见问题

下一步