GenerateCosplayImage
生成专区(aigen)类目下的Cosplay-动漫人物生成GenerateCosplayImage的语法及示例
服务地址:
华东2(上海)
输入参数
只看必填
FaceImageUrl输入的人脸图像URL
TemplateImageUrl输入的模板图像 URL
Style生成风格
插件下载了解更多
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.

接口说明

功能描述

通过输入人像图片和卡通形象图片,可快速生成人物卡通写真。目前支持 3D 卡通形象和真人形象两种风格。 关于该接口功能的示例图如下:

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

    应用场景

    • 社交媒体个性化:可以在社交媒体平台上传自己的照片,并使用人物动漫化工具将其转换为卡通形象作为头像或分享给好友,展现个性和创意。
    • 纪念品定制与艺术创作:制作个人化的动漫肖像画、T 恤印花、杯子图案等定制商品,用于生日礼物、节日纪念或者艺术收藏。
    • 游戏与虚拟世界:在游戏设计中,可以将玩家的真实照片转化为动漫角色,用于游戏角色创建或个性化装扮,增强沉浸式体验。
    • 数字营销与广告设计:广告商在宣传活动中采用动漫化的人物形象,以新颖、有趣的方式吸引消费者关注,尤其适合年轻人群体的市场推广。
    • 教育与培训:在教育软件和在线课程中,将教师或学生形象动漫化,既保护隐私又增加了趣味性,有助于提高学习兴趣和参与度。
    • 内容创作与动画制作:动漫风格的人物生成可用于动画短片、漫画书以及网络表情包的快速制作,简化了美术设计流程,降低了内容创作者的门槛。
    • 视频编辑与特效处理:在视频剪辑软件中集成人物动漫滤镜,支持用户轻松制作出具有动漫效果的 MV、短视频或其他创意作品。

    特色优势

    • 复刻人物表情:基于深度学习算法,能够准确识别人物的性别、表情等特征,并在生成的卡通头像上高度还原真实人物的表情。
    • 全身卡通化:不仅限于人脸的卡通化处理,提供全身卡通化的功能,从而避免因仅对脸部进行卡通化而可能产生的不协调感,如笑场等尴尬场景。
    • 批量稳定特效生成:该技术在社交媒体、游戏开发、广告设计、数字教育、娱乐产业等多个领域都可广泛应用,为各行业带来创新与活力。
    • 广泛适用性:该技术在社交媒体、游戏开发、广告设计、数字教育、娱乐产业等多个领域都可广泛应用,为各行业带来创新与活力。

    接入指引

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

    输入限制

    • 图像格式:JPG、JPEG、PNG。
    • 图像大小:不超过 4 MB。
    • 人脸图像:大于等于 256x256 像素,小于等于 5760x3240 像素,长宽比不超过 1:2。
    说明 当图像分辨率超过最大限制时,请先将图片进行缩放,调整图片大小,具体请参见图片缩放
    • 模板图像:大于等于 256x256 像素,小于等于 5760x3240 像素,长宽比不超过 1:1.5,如果超过将自适应裁剪至 1:1.5。
    说明 当图像分辨率超过最大限制时,请先将图片进行缩放,调整图片大小,具体请参见图片缩放
    • URL 地址中不能包含中文字符。

    调用步骤

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

    计费说明

    Cosplay-动漫人物生成能力目前处于公测期,可免费调用。

    请求参数

    字段名称字段详情
    FaceImageUrlstring

    输入的人脸图像 URL。推荐使用上海地域的 OSS 链接,对于文件在本地或者非上海地域 OSS 链接的情况,请参见文件 URL 处理。输入限制如下:展开详情

    示例值:http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/aigen/xxx01.png
    TemplateImageUrlstring

    输入的模板图像 URL。推荐使用上海地域的 OSS 链接,对于文件在本地或者非上海地域 OSS 链接的情况,请参见文件 URL 处理。输入限制如下:展开详情

    示例值:http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/aigen/xxx02.png
    Styleinteger<int64>

    生成风格。取值范围:展开详情

    注意 该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。
    示例值:0

    返回参数

    字段名称字段详情
    RequestIdstring

    请求 ID。

    示例值:59697D68-2A6E-4553-89BD-0FADD07881E8
    Dataobject

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

    Messagestring

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

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

    返回说明

    SDK 参考

    阿里云视觉 AI 生成专区类目下的 Cosplay-动漫人物生成能力推荐使用 SDK 调用,支持多种编程语言,调用时请选择 AI 类目为生成专区(aigen)的 SDK 包,文件参数通过 SDK 调用可支持本地文件及任意 URL,具体可参见 SDK 总览

    示例代码

    该能力常用语言的示例代码,请参见Cosplay-动漫人物生成示例代码

    变更历史
    暂无变更历史