GenerateHumanAnimeStyleVideo_视觉智能开放平台-视频生产_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

功能描述

根据输入的人像视频进行卡通化转换,返回风格化后的视频结果。支持日漫(anime)、3D(3d)、手绘(handdrawn)、铅笔画(sketch)、艺术特效(artstyle)风格。 关于该接口功能的示例图如下:

说明
  • 您可以进入在线咨询获取在线人工帮助。
    • 当前能力可在视觉智能开放平台有完整的免费产品体验,您可以单击立即试用对该能力进行更直观试用以及在线购买。
    • 阿里云视觉智能开放平台视觉 AI 能力 API 接入、接口使用或问题咨询等,请通过钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。

    应用场景

    • 趣味视频处理:上传人像视频,即可生成专属动漫化形象,塑造可爱氛围,可用于互动推广、趣味相册等应用场景。
    • 隐私保护:为保护图像中的人物隐私,将人物卡通化,可避免识别出原人物是谁。与马赛克等处理方法相比,更具趣味性,更易于用户接受,提升用户体验。

    特色优势

    • 内容高保真:基于深度学习算法,能有效保留原图中的人物表情、配饰、背景等细节内容特征。
    • 多种风格选择:提供多种不同特效的风格选择,实现差异化的制作效果,满足不同场景和数据要求。
    • 全身卡通化:全图的精细化风格转换,相比人脸卡通化,可避免笑场等尴尬场景。
    • 多人模式:可处理情侣照、家庭照、团体类照片。

    接入指引

    1. 注册阿里云账号:打开阿里云官网,在阿里云官网右上角,单击立即注册,按照操作提示完成账号注册。
    2. 开通能力:请确保您已开通视频生产服务,若未开通服务请立即开通
    3. 创建 AccessKey:请确保您已创建 AccessKey,如果您使用的是子账号 AccessKey,您需要给子账号赋予 AliyunVIAPIFullAccess 权限,具体操作,请参见 RAM 授权
    4. 在线调试(可选):您可以通过OpenAPI Explorer在线调试能力,查看完整的调用示例代码及 SDK 依赖信息,也可以下载完整的工程。
    5. 开发接入步骤:
    • SDK 总览中选择您要接入使用的 SDK 语言。
    • 在对应语言的 SDK 文档中找到 AI 类目为视频生产(videoenhan)类目的 SDK 包进行安装。
    • 参考文档中提供的示例代码进行适当修改后调用。
    1. 示例代码:该能力常用语言的示例代码,请参见视频人像卡通化示例代码,常用语言查询异步任务结果的示例代码,请参见查询异步任务结果示例代码

    2. 客户端直接调用:该能力常用的客户端调用方式包括以下几种。

    输入限制

    • 支持的视频类型:MP4、AVI、MKV、FLV、MOV、MPG、TS、MXF。
    • 建议输入视频分辨率不超过 1920x1080 像素。
    • 视频大小不超过 1 GB。
    • URL 地址中不能包含中文字符。
    • 视频帧画面里人数不超过 5 人,超过 5 人会影响实际效果。

    计费说明

    该接口返回结果中不会包含计费信息,视频人像卡通化按照视频输出时长进行计费,时长最小计量单位为秒,时长不足 1 秒按照 1 秒进行计费。计费方式及报价详情,请参见计费介绍

    说明
  • 下方调试接口为付费接口。
    • 该能力为异步能力,调用失败不计费,通过 RequestId 查询结果不计费。

    调用步骤

    该能力为异步能力,需分两步进行调用。 第一步调用 GenerateHumanAnimeStyleVideo 接口提交任务,请求成功后,得到一个任务 ID。 第二步调用 GetAsyncJobResult 接口查询结果,根据任务 ID 查询任务执行状态和结果。如果任务还在处理中,可稍等一段时间后再进行查询。

    流控信息

    当前云产品API请求速率暂未透出。

    授权信息

    如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

    具体说明如下:展开详情

    操作访问级别资源类型条件关键字关联操作
    viapi-videoenhan:GenerateHumanAnimeStyleVideo
    全部资源
    *

    请求参数

    字段名称字段详情
    VideoUrlstring

    视频 URL 地址。推荐使用上海地域的 OSS 链接,对于文件在本地或者非上海地域 OSS 链接的情况,请参见文件 URL 处理

    示例值:https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/xxx/eas/EvaluateVideoQuality/123.mp4参考取值来源:
      AdjustVideoColor
      GenerateVideo
      AbstractFilmVideo
      SuperResolveVideo
      EraseVideoLogo
      ChangeVideoSize
      EnhancePortraitVideo
      ReduceVideoNoise
    CartoonStylestring

    卡通化的风格。取值如下:展开详情

    示例值:anime

    返回参数

    字段名称字段详情
    RequestIdstring

    请求 ID。

    示例值:d21a2afa-4d52-4bca-803b-e65028146603
    Dataobject

    返回的结果数据内容。该数据需要在异步任务执行成功后,通过调用 GetAsyncJobResult 接口,对其 Result 字段进行 JSON 反序列化之后得到。

    Messagestring

    提交异步任务后的提示信息。

    示例值:该调用为异步调用,任务已提交成功,请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。

    返回说明

    查询结果

    该接口为异步接口,当前并未返回真实的请求结果,您需要通过返回的 RequestId 调用 GetAsyncJobResult 接口来获取该接口的真实请求结果。详情请参见 GetAsyncJobResult

    SDK 参考

    阿里云视觉 AI 视频生产类目下的视频人像卡通化能力推荐使用 SDK 调用,支持多种编程语言,调用时请选择 AI 类目为视频生产(videoenhan)的 SDK 包,文件参数通过 SDK 调用可支持本地文件及任意 URL,具体可参见 SDK 总览

    示例代码

    该能力常用语言的示例代码,请参见视频人像卡通化示例代码,常用语言查询异步任务结果的示例代码,请参见查询异步任务结果示例代码

    返回示例

    变更历史

    暂无变更历史

    相关示例