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

适用场景

• 教育科普：快速将童话故事、古诗词、科普知识等文本内容，生成寓教于乐的 AI 视频。
• 小说推广：根据小说核心情节或精彩片段，自动生成引人入胜的营销短视频，用于社交媒体推广。
• 内容创作：为短视频创作者提供灵感和基础素材，快速将创意文案转化为视频初稿，提升创作效率。

计费说明

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

• AI 文字成片费用：按最终输出的视频时长计费，并根据输出分辨率采用不同的计费系数。具体价格请见智能应用 Aideo Agent 计费。
• 媒资存储费用：AI 文字成片生成的新视频，需要存储在视频点播空间中。这将根据存储量和存储时长产生费用，详见媒资存储计费。
• 视频分发费用：如果您通过视频点播的 CDN 分发加速功能来播放或下载生成的视频，将产生分发加速费用，详见分发加速计费。

能力与限制

前提条件

• 已注册火山引擎账号并完成实名认证。
• 已开通视频点播服务并创建空间。
• （可选）添加并配置点播加速域名。如果您需要通过视频点播的 CDN 分发加速功能来播放或下载生成的视频产物，则需完成此步骤。

实现流程

步骤 1：提交 AI 文字成片任务

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

• Scene: 必须设置为 aigclongvideo，代表 AI 文字成片场景。
• Uploader: 设置任务产物（生成的视频）要上传到的点播空间名称。
• ParamObj: 传入一个包含了故事文本、输出分辨率等信息的 JSON 结构体。详细结构请参考下文。
• CallbackArgs: 自定义回调参数。该参数值会通过 VCreativeComplete 事件或GetVCreativeTaskResult 接口中的 CallbackArgs 参数返回给您的服务端。

AI 文字成片请求参数说明

ParamObj 支持以下字段：

请求示例：

POST https://vod.volcengineapi.com?Action=AsyncVCreativeTask&Version=2018-01-01
{
  "Uploader": "your_output_space_name",
  "Scene": "aigclongvideo",
  "CallbackArgs": "task_for_story_generation",
  "ParamObj": {
    "story": "一个关于勇敢的小狐狸在森林里寻找友谊的温暖故事",
    "resolution": "720p"
  }
}

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

步骤 2：获取 AI 文字成片任务结果

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

方式 1：主动轮询

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

GET https://vod.volcengineapi.com?Action=GetVCreativeTaskResult&Version=2018-01-01&VCreativeId=20251022v20xxxxxxxdd28d49019ebd42cf878cetob

方式 2：配置事件通知

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

步骤 3：解析任务结果

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

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

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

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

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

步骤 4：获取产物播放地址

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