You need to enable JavaScript to run this app.
文档中心
视频点播

视频点播

复制全文
下载 pdf
视频 AI 应用
AI 漫剧转绘
复制全文
下载 pdf
AI 漫剧转绘

视频点播 AI 漫剧转绘功能支持将真人实拍视频(如短剧),通过智能场景切分、内容理解、风格迁移和视频生成等多项 AI 技术,转换为具有多样化艺术风格的全新视频(例如动漫风、3D 卡通风、素描风)。您可以借此将现有的真人视频素材,低成本、批量化地转化为风格独特的动漫或卡通内容,从而丰富内容形态、提升用户吸引力。该功能适用于真人短剧的动漫化改编、营销视频的创意视觉升级,以及社交媒体内容的风格化处理等场景。

本文档将指导您如何通过调用视频点播 OpenAPI,实现真人视频的 AI 漫剧转绘。

适用场景

  • 短剧漫改:快速将真人短剧转换为动漫版本,以较低成本开拓新的内容赛道和观众群体。
  • 营销动画制作:将产品介绍、品牌故事等实拍视频,一键转换为风格独特的动画广告,提升创意吸引力。
  • 内容二次创作:为 Vlog、影视片段等内容进行 AI 艺术化处理,生成有趣的二创作品,丰富内容生态。

计费说明

使用 AI 漫剧转绘会产生以下费用:

  • 视频风格转换费用:按最终输出的风格化视频时长计费,并根据输出分辨率采用不同的计费系数。具体价格请见视频风格转换计费换算系数
  • 媒资存储费用:您上传用于风格转换的原始视频,以及风格转换后生成的新视频,都需要存储在视频点播空间中。这将根据存储量和存储时长产生费用,详见媒资存储计费
  • 视频分发费用:如果您通过视频点播的 CDN 分发加速功能来播放或下载风格转换生成的视频,将产生分发加速费用,详见分发加速计费

能力与限制

项目

说明

输入视频

  • 时长限制:输入视频的时长不超过 5 分钟。
  • 音频要求:视频必须包含音频轨道。
  • 内容安全:视频内容(画面、音频、字幕)将经过大模型的安全审核。如果包含敏感或不合规因素,任务可能会被拦截或失败。
  • 效果建议:为提升转绘效果,推荐使用镜头较大、场景较为简单的视频。复杂的场景和快速切换的镜头可能会影响 AI 的理解和生成效果。

资源与并发限制

当前每个账号仅支持 1 个任务并发执行。如果您在有任务正在执行时提交新任务,新任务将会进入排队状态,等待前面的任务完成后再开始执行。根据当前模型预估,处理一段 1 分钟的视频大约需要 10 分钟。请您提交任务后耐心等待。

前提条件

实现流程

步骤 1:提交 AI 漫剧转绘任务

调用 AsyncVCreativeTask 接口提交一个 AI 漫剧转绘任务。核心参数配置如下:

  • Scene: 必须设置为 videostyletrans,代表 AI 漫剧转绘场景。
  • Uploader: 设置任务产物(生成的视频)要上传到的点播空间名称。
  • ParamObj: 传入一个包含了输入视频、转绘风格等信息的 JSON 序列化后的字符串。详细结构请参考下文。
  • CallbackArgs: 自定义回调参数。该参数值会通过 VCreativeComplete 事件或 GetVCreativeTaskResult 接口中的 CallbackArgs 参数返回给您的服务端。

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

AI 漫剧转绘工作流参数说明

ParamObj 字符串支持以下字段:

字段

类型

必填

描述

input

String

输入视频。格式为 vid://

style

String

转绘风格。默认为"漫画风"。您可自定义风格,例如"3D卡通风格"。

resolution

String

输出视频分辨率。支持:

  • 480p
  • 720p
  • 1080p

请求示例

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

POST https://vod.volcengineapi.com?Action=AsyncVCreativeTask&Version=2018-01-01
{
  "Uploader": "your_output_space_name",
  "Scene": "videostyletrans",
  "CallbackArgs": "task_for_cartoon_style",
  "ParamObj": {
    "input": "vid://v022d2g10065d***bcde123456",
    "style": "3D卡通风格",
    "resolution": "1080p"
  }
}

步骤 2:获取 AI 漫剧转绘任务结果

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

方式 1:主动轮询

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

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

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

方式 2:配置事件通知

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

步骤 3:解析 AI 漫剧转绘任务结果

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

  • Statussuccess 时,OutputJson 字符串在反序列化后,结构如下:

    {
      "vid": "v022d2g10065d3rk***"
    }
    

    字段

    类型

    描述

    vid

    String

    产物视频的唯一 ID。

  • Statusfailed_run 时,OutputJson 字段为错误信息字符串,示例如下:

    "OutputJson": "internal error: node VEdit_Track_ID error [code]=21020004, [message]={\"code\":21020004,\"error_message\":\"{\\\"code\\\":21020004,\\\"message\\\":\\\"Json数据验证不通过,异常字段:Track 0 0 TargetTime 异常信息:[] is too short\\\"}\",\"message\":\"{\\\"code\\\":21020004,\\\"message\\\":\\\"Json数据验证不通过,异常字段:Track 0 0 TargetTime 异常信息:[] is too short\\\"}\"}, [task]=e0102daa8e6d4f7b***a8c933ee08013, [srv]=VEdit"
    

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

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

说明

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

最近更新时间:2025.12.19 15:35:03
这个页面对您有帮助吗?
有用
有用
无用
无用