文档中心

视频点播

视频 AI 应用

AI 文字成片

视频点播 AI 文字成片功能支持用户输入一段文本，通过 AI 自动生成一个包含 AI 绘画、智能配音和字幕的短视频（30 秒左右）。该功能深度整合文本大模型、文生图及语音合成（TTS）等多项 AI 技术，能够将您的创意文字一键转化为生动有趣的视频内容。本文指导您通过调用视频点播 OpenAPI，实现从文本到视频的自动化生成。

适用场景

教育科普：快速将童话故事、古诗词、科普知识等文本内容，生成寓教于乐的 AI 视频。

小说推广：根据小说核心情节或精彩片段，自动生成引人入胜的营销短视频，用于社交媒体推广。

内容创作：为短视频创作者提供灵感和基础素材，快速将创意文案转化为视频初稿，提升创作效率。

计费说明

使用 AI 文字成片会产生以下费用：

AI 文字成片费用：按最终输出的视频时长计费，并根据输出分辨率采用不同的计费系数。具体价格请见智能应用 Aideo Agent 计费。

媒资存储费用：AI 文字成片生成的新视频，需要存储在视频点播空间中。这将根据存储量和存储时长产生费用，详见媒资存储计费。

视频分发费用：如果您通过视频点播的 CDN 分发加速功能来播放或下载生成的视频，将产生分发加速费用，详见分发加速计费。

能力与限制

项目	说明
输入文本	内容建议：建议输入简短、清晰的故事主题或一句话梗概（例如“亡羊补牢的故事”），以便大模型更好地理解和创作。内容安全：您输入的文本内容以及 AI 生成的视频（画面、音频、字幕）都将经过严格的安全审核。如果包含敏感或不合规因素，任务可能会被拦截或执行失败。
资源与并发限制	当前每个账号仅支持 1 个任务并发执行。如果您在有任务正在执行时提交新任务，新任务将会进入排队状态，等待前面的任务完成后再开始执行。根据当前模型预估，处理一段 1 分钟的视频大约需要 10 分钟。请您提交任务后耐心等待。

前提条件

已注册火山引擎账号并完成实名认证。

已开通视频点播服务并创建空间。

（可选）添加并配置点播加速域名。如果您需要通过视频点播的 CDN 分发加速功能来播放或下载生成的视频产物，则需完成此步骤。

实现流程

步骤 1：提交任务

调用 AsyncVCreativeTask 接口提交一个异步的 AI 文字成片任务。核心参数配置如下：

Scene: 必须设置为 aigclongvideo，代表 AI 文字成片场景。

Uploader: 设置任务产物（生成的视频）要上传到的点播空间名称。

ParamObj: 传入一个包含了故事文本、输出分辨率等信息的 JSON 结构体。详细结构请参考下文。

CallbackArgs: 自定义回调参数。该参数值会通过 VCreativeComplete 事件或GetVCreativeTaskResult 接口中的 CallbackArgs 参数返回给您的服务端。

AI 文字成片请求参数说明

ParamObj 支持以下字段：

字段	类型	必填	描述
story	String	是	用于生成视频的故事文本或一句话梗概。例如：“桃园三结义”。
resolution	String	否	输出视频的分辨率。默认为 480p。支持以下枚举值： 480p、720p、1080p。

请求示例：

说明

以下 HTTP 示例仅展示核心的业务参数，省略了 Authorization 请求头中的签名计算等鉴权细节。在实际发起请求前，请参考如何调用 OpenAPI 文档，了解如何在线测试接口、获取可运行的 curl 命令以及完整的 HTTP 请求构造方法与签名机制。

成功提交后，系统将返回任务的唯一标识 VCreativeId。请务必保存好此 ID，以便后续查询结果。

步骤 2：获取任务结果

任务提交后，系统会在后台进行异步处理。您可通过以下方式获取任务结果。

方式 1：主动轮询

轮询 GetVCreativeTaskResult 接口并传入步骤 1 中获取的 VCreativeId 主动获取任务结果。请求示例如下：

方式 2：配置事件通知

参考事件通知概述文档，配置一个用于接收回调的服务地址。在订阅事件时，勾选 AI 智剪任务完成事件。当任务完成时，您的服务将收到一个 EventType 为 VCreativeComplete 的 HTTP POST 请求。

步骤 3：解析任务结果

无论通过哪种方式，您都需要解析 OutputJson 字段获取产物信息。OutputJson 的内容和结构取决于任务的最终 Status：

当 Status 为 success 时，OutputJson 字符串在反序列化后，结构如下：

{
"vid": "v024d0g10004d3***og65n8pg1615g"
}

字段
类型
描述
vid
String
产物视频的唯一 ID。

当 Status 为 failed_run 时，OutputJson 字段为包含具体原因的错误信息字符串。

步骤 4：获取产物 URL

说明

前提条件：在获取文件的公网 URL 之前，您必须为产物所在的点播空间添加并配置一个加速域名。所有 URL 都将基于此域名生成。

在步骤 3 中成功获取到生成的视频的 Vid 后，可调用 GetPlayInfo 接口来获取该视频的播放地址。成功调用后，您将从返回结果的 PlayInfoList 中获取到播放 URL，可直接用于播放器或分发。

最近更新时间：2026.09.15 10:35:33

这个页面对您有帮助吗？

有用

无用