视频点播支持将真人实拍的视频(如短剧),通过 AI 自动转换为具有多样化艺术风格的视频(例如动漫风、3D卡通风、素描风)。AI 漫剧转绘工作流整合了智能场景切分、内容理解、风格迁移和视频生成等多项 AI 技术,最终输出与原始音画同步的、全新的风格化视频。本文指导您通过调用视频点播 OpenAPI,实现将真人视频转绘为风格化的视频。
使用 AI 漫剧转绘会产生以下费用:
使用 AI 漫剧转绘功能前,请注意以下限制与建议:
调用 AsyncVCreativeTask 接口提交一个 AI 漫剧转绘任务。核心参数如下:
WorkflowId: 必须设置为 loki://154160112。Uploader: 设置产物视频要上传到的点播空间。ParamJson: 传入一个包含了输入视频、转绘风格等信息的 JSON 字符串。详细结构请参考 AI 漫剧转绘工作流参数说明。请求示例:
POST https://vod.volcengineapi.com?Action=AsyncVCreativeTask&Version=2018-01-01 { "Uploader": "your-upload-space", "WorkflowId": "loki://154160112", "ParamJson": "{"input":"vid://v022d2g10065d***bcde123456","space_name":"your-source-space","style":"漫画风","resolution":"1080p"}" }
成功提交后,系统将返回任务的唯一标识 VCreativeId。请务必保存好此 ID,以便后续查询结果。
任务提交后,系统会在后台进行异步处理。您可通过以下方式获取任务结果:
主动查询:轮询 GetVCreativeTaskResult 接口并传入步骤 1 中获取的 VCreativeId 主动获取任务结果。当返回结果中的 Status 字段值为 success 时,表示任务已成功完成。您可以解析 OutputJson 字段来获取产物信息。获取成功结果的示例:
{ "ResponseMetadata": { ... }, "Result": { "Status": "success", "OutputJson": "{\"vid\":\"v0aabbcc...\"}", ... } }
配置事件通知:
EventType 为 VCreativeComplete 的 HTTP POST 请求。请求体中的 Data 对象即为任务结果。您可以根据 Data.Code 字段判断任务是否成功,并解析 Data.OutputJson 获取产物信息。说明
无论通过哪种方式,您都需要解析 OutputJson 字段获取产物信息。OutputJson 结构的详细说明,请参见 AI 漫剧转绘工作流结果说明。
当您调用 AsyncVCreativeTask 接口并指定 AI 漫剧转绘工作流时,ParamJson 字符串支持以下字段:
字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
input | String | 是 | 输入视频。格式为 vid:// |
space_name | String | 是 | 输入视频所在的点播空间名称。 注意
|
style | String | 否 | 转绘风格。默认为"漫画风"。您可自定义风格,例如"3D卡通风格"。 |
resolution | String | 是 | 输出视频分辨率。支持:
|
当您通过 GetVCreativeTaskResult 接口查询 AI 漫剧转绘任务结果时,OutputJson 的内容和结构取决于任务的最终 Status。
当 Status 为 success 时,OutputJson 字符串在反序列化后,结构如下:
{ "vid": "v022d2g10065d3rk***" }
字段 | 类型 | 描述 |
|---|---|---|
vid | String | 产物视频的唯一 ID。 |
当 Status 为 failed_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"