视频风格重绘、视频动漫化、视频风格化、视频人像重绘、视频卡通化、视频风格转化

视频风格重绘

说明

支持的领域 / 任务：aigc /视频风格重绘

视频风格重绘可以将输入的视频帧序列进行多种风格化的重绘/生成，使新视频画面在兼顾原始人物和物体相貌的同时，带来不同风格的绘画效果。当前支持预置重绘风格包括日式漫画、美式漫画、清新漫画、3D卡通、国风卡通、纸艺风格、简易插画、国风水墨。

输入内容&效果示意

原始视频（输入）
日式漫画（输出）
美式漫画（输出）
清新漫画（输出）
3D卡通（输出）
国风卡通（输出，古装输入最佳）
纸艺风格（输出）
简易插画（输出）
国风水墨（输出）

应用场景

趣味视频创作：上传人像、风景等短视频，即可生成专属视频动漫化、卡通画系列形象，塑造可爱氛围，可用于互动推广、趣味相册等应用场景。
IP隐私保护：为保护图像中的人物隐私，将人物卡通化，可避免识别出原人物是谁。与马赛克等处理方法相比，更具趣味性，更易于用户接受，提升用户体验。
视频后期制作：通过风格转换可以实现特殊的视觉效果，如将现实场景转换成3D卡通或国风卡通系列画面，增加艺术感，以较低成本创造出高质量的艺术视觉效果。
广告营销创作：品牌可以通过风格转换技术来制作具有独特视觉风格的广告片，吸引目标受众的注意。能够快速适应不同的市场趋势和消费者偏好，提高广告的吸引力和记忆点。
媒体内容创作：社交媒体上的内容创作者可以使用风格转换技术来制作个性化的短视频，提升内容的独特性和观赏性。帮助创作者在众多内容中脱颖而出，增强粉丝互动和分享意愿。

特色优势

多种风格选择：提供多种不同特效的风格选择，实现差异化的制作效果，满足不同场景和数据要求，全视频精细化多样性风格转换。
多人像精致重绘：可处理情侣照、家庭照、团体类照片进行人像风格重绘，使新视频画面在兼顾原始人物和物体相貌的同时，带来不同风格的精致绘画效果。
稳定、易用平台服务：提供高并发、大流量下的稳定服务，支持简单训练和调用的API接口，易于集成，兼容性强。

模型概览

模型简介

模型名	模型简介
模型名	模型简介

模型名	模型简介

video-style-transform	视频风格重绘可以将输入的视频帧序列进行多种风格化的重绘/生成，使新视频画面在兼顾原始人物和物体相貌的同时，带来不同风格的绘画效果。当前支持预置重绘风格包括日式漫画、美式漫画、清新漫画、3D卡通、国风卡通、纸艺风格、简易插画、国风水墨。

模型说明

模型名	免费额度	计费单价		限流（含主账号与RAM子账号）
模型名	免费额度	计费单价		任务下发接口QPS限制	同时处理中任务数量

模型名	免费额度	计费单价		限流（含主账号与RAM子账号）
				任务下发接口QPS限制	同时处理中任务数量
video-style-transform	免费额度：10分钟领取方式：开通阿里云百炼大模型服务后，自动发放有效期：180天	720P	0.5元/s	2	1
		540P	0.2元/s

输入限制

视频分辨率：可支持输入分辨率范围：单边不小于256且不超过4096，且长边比短边不超过1.8。
视频格式：MP4，AVI，MKV，MOV， FLV，TS，MPG，MXF。
视频时长：不超过30秒。
视频大小：不超过100M。
URL地址中不能包含中文字符。

HTTP调用接口

功能描述

本模型需要相对较长的算法调用时间，所以在接口层面采用了异步调用的方式进行任务提交，在通过任务接口提交作业之后，系统会返回对应的作业ID，随后可以通过对应的异步作业查询接口获取任务的状态并且在作业到达最终完成态后取回对应的作业结果。

前提条件

已开通服务并获得API-KEY：获取API Key、配置API Key到环境变量。

作业提交接口调用

POST https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis

请求头（Headers）	请求示例 `curl --location --request POST 'https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \ --header 'X-DashScope-Async: enable' \ --header 'Authorization: Bearer $API-Key' \ --header 'Content-Type: application/json' \ --header 'X-DashScope-DataInspection: enable' \ --data-raw '{ "model": "video-style-transform", "input": { "video_url": "http://xxx/input.mp4" }, "parameters":{ "style":0, "video_fps":15 } }'` 说明需要使用您的百炼API-KEY替换示例中的`$API-Key`。
Content-Type string 必选请求内容类型。固定为`application/json`。
Authorization string 必选推荐您使用百炼API-Key，也可填`DashScope API-Key`。例如：`Bearer d1xxx2a`。
X-DashScope-Async string 必选是否开启异步处理。必须开启异步处理，设置为`enable`。
请求体（Request Body）
model string 必选指明需要调用的模型。设置为`video-style-transform`。
input object 必选输入图像的基本信息，比如图像URL。属性 video_url string 必选输入图像URL地址。例如：`http://xxx/input.mp4`。图像限制：视频分辨率：可支持输入分辨率范围：单边不小于256且不超过4096，且长边比短边不超过1.8。视频格式：MP4，AVI，MKV，MOV， FLV，TS，MPG，MXF。视频时长：不超过30秒。视频大小：不超过100M。 URL地址中不能包含中文字符。
parameters object 必选图像处理参数。 720p 540p 属性 style int 可选风格类型，预置类型如下： 0：日式漫画，默认值 1：美式漫画 2：清新漫画 3：3D卡通 4：国风卡通 5：纸艺风格 6：简易插画 7：国风水墨 video_fps int 可选生成视频的帧率，默认为15，范围区间为[15, 25]。 animate_emotion bool 可选是否进行表情驱动后处理，默认为`true`。属性 style int 可选风格类型，预置类型如下： 0：日式漫画，默认值 1：美式漫画 2：清新漫画 3：3D卡通 4：国风卡通 5：纸艺风格 6：简易插画 7：国风水墨 video_fps int 可选生成视频的帧率，默认为15，范围区间为[15, 25]。 animate_emotion bool 可选是否进行表情驱动后处理，默认为`true`。 min_len int 必选短边长度。默认为 `540`。 use_SR bool 可选是否进行超分后处理，默认为`false`, 此模式建议开启，设置为`true`。

响应	成功响应异常响应 `{ "output": { "task_id": "xxxxxxxx", "task_status": "PENDING" } "request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51" }` `{ "code":"InvalidApiKey", "message":"Invalid API-key provided.", "request_id":"fb53c4ec-1c12-4fc4-a580-xxxxxxxxxxxx" }`
output object 任务输出信息。属性 task_id string 任务id，任务唯一标识。 task_status string 任务状态。 PENDING：排队中 RUNNING：处理中 SUSPENDED：挂起 SUCCEEDED：执行成功 FAILED：执行失败
request_id string 本次请求的系统唯一码。

作业任务状态查询和结果获取接口

GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}

请求头（Headers）	获取任务结果 `curl -X GET \ --header 'Authorization: Bearer $API-Key' \ https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}` 说明您需要将示例中的`$API-Key`替换为您的百炼API-KEY。您需要将`{task_id}`替换为作业提交接口输出的`task_id`。
Authorization string 必选推荐使用百炼API-Key，也可填`DashScope API-Key`。例如：`Bearer d1xxx2a`。
URL路径参数（Path parameters）
task_id string 必选任务id。

响应	任务执行成功任务执行中任务执行失败请求失败作业成功完成后，再次查询状态时接口会返回作业状态和结果。对于本模型，完成后的作业状态在系统中保留24小时，之后将被删除，相关结果（图像URL）也一并清除。图像URL的下载有效期为24小时，请及时使用或保存结果。 `{ "request_id": "b67df059-ca6a-9d51-afcd-xxxxxxxxxxxx", "output": { "task_id": "d76ec1e8-ea27-4038-8913-xxxxxxxxxxxx", "task_status": "SUCCEEDED", "submit_time": "2024-05-16 13:50:01.247", "scheduled_time": "2024-05-16 13:50:01.354", "end_time": "2024-05-16 13:50:27.795", "output_video_url": "http://xxx/result.mp4" }, "usage": { "duration": 10, "SR": 540 } }` 作业提交后将处于排队状态，在得到调度之后将转为运行状态，此时作业的状态为RUNNING，`task_metrics`将给出具体`batch`状态； `{ "request_id":"e5d70b02-ebd3-98ce-9fe8-xxxxxxxxxxxx", "output":{ "task_id":"13b1848b-5493-4c0e-xxxxxxxxxxxx", "task_status":"RUNNING", "task_metrics":{ "TOTAL":1, "SUCCEEDED":1, "FAILED":0 } } }` `{ "request_id": "dccfdf23-b38e-97a6-a07b-xxxxxxxxxxxx", "output": { "task_id": "4cbabbdf-2c1f-43f4-b983-xxxxxxxxxxxx", "task_status": "FAILED", "submit_time": "2024-05-16 14:15:14.103", "scheduled_time": "2024-05-16 14:15:14.154", "end_time": "2024-05-16 14:15:14.694", "code": "InvalidParameter.FileDownload", "message": "download for input video error" } }` 如果因为某种原因作业失败，则作业状态会设置为`FAILED`，并且通过`code`和`message`字段指明错误原因。 `{ "request_id": "7574ee8f-38a3-4b1e-9280-xxxxxxxxxxxx" "output": { "task_id": "a8532587-fa8c-4ef8-82be-xxxxxxxxxxxx", "task_status": "FAILED", "code": "xxx", "message": "xxxxxx", } }`
status_code int `200（HTTPStatus.OK）`表示请求成功，否则表示请求失败，可以通过`code`获取错误码，通过`message`字段获取错误详细信息。
request_id string 请求唯一标识。可用于请求明细溯源和问题排查。
code string 如果失败表示错误码，参考错误码。
message string 如果失败，内容为失败详细信息。
usage object 输出信息统计。属性 duration float 生成视频时长（秒）。
output object 任务输出信息。属性 output_video_url string 结果视频URL地址。例如：`http://xxx/result.mp4`。 task_status string 任务状态。 PENDING：排队中 RUNNING：处理中 SUSPENDED：挂起 SUCCEEDED：执行成功 FAILED：执行失败 UNKNOWN：任务不存在或状态未知。

错误码

如果模型调用失败并返回报错信息，请参见错误信息进行解决。

同时本模型还有如下特定错误码：

HTTP返回码	错误码（code）	错误信息（message）	含义说明

HTTP返回码	错误码（code）	错误信息（message）	含义说明
400	InvalidParameter.JsonPhrase	input json error	输入JSON错误
400	InvalidParameter.FileDownload	oss download error	输入图像下载失败
400	InvalidParameter.VideoFormat	read video error	读取视频失败
400	InvalidParameter	the xxx parm is not invalid!	输入参数超出范围
500	InternalError.Algo	algorithm process error	算法错误
500	InternalError.FileUpload	oss upload error	文件上传失败

请求头（Headers）	请求示例 `curl --location --request POST 'https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \ --header 'X-DashScope-Async: enable' \ --header 'Authorization: Bearer $API-Key' \ --header 'Content-Type: application/json' \ --header 'X-DashScope-DataInspection: enable' \ --data-raw '{ "model": "video-style-transform", "input": { "video_url": "http://xxx/input.mp4" }, "parameters":{ "style":0, "video_fps":15 } }'` 说明需要使用您的百炼API-KEY替换示例中的`$API-Key`。
Content-Type string 必选请求内容类型。固定为`application/json`。
Authorization string 必选推荐您使用百炼API-Key，也可填`DashScope API-Key`。例如：`Bearer d1xxx2a`。
X-DashScope-Async string 必选是否开启异步处理。必须开启异步处理，设置为`enable`。
请求体（Request Body）
model string 必选指明需要调用的模型。设置为`video-style-transform`。
input object 必选输入图像的基本信息，比如图像URL。属性 video_url string 必选输入图像URL地址。例如：`http://xxx/input.mp4`。图像限制：视频分辨率：可支持输入分辨率范围：单边不小于256且不超过4096，且长边比短边不超过1.8。视频格式：MP4，AVI，MKV，MOV， FLV，TS，MPG，MXF。视频时长：不超过30秒。视频大小：不超过100M。 URL地址中不能包含中文字符。
parameters object 必选图像处理参数。 720p 540p 属性 style int 可选风格类型，预置类型如下： 0：日式漫画，默认值 1：美式漫画 2：清新漫画 3：3D卡通 4：国风卡通 5：纸艺风格 6：简易插画 7：国风水墨 video_fps int 可选生成视频的帧率，默认为15，范围区间为[15, 25]。 animate_emotion bool 可选是否进行表情驱动后处理，默认为`true`。属性 style int 可选风格类型，预置类型如下： 0：日式漫画，默认值 1：美式漫画 2：清新漫画 3：3D卡通 4：国风卡通 5：纸艺风格 6：简易插画 7：国风水墨 video_fps int 可选生成视频的帧率，默认为15，范围区间为[15, 25]。 animate_emotion bool 可选是否进行表情驱动后处理，默认为`true`。 min_len int 必选短边长度。默认为 `540`。 use_SR bool 可选是否进行超分后处理，默认为`false`, 此模式建议开启，设置为`true`。

请求头（Headers）	获取任务结果 `curl -X GET \ --header 'Authorization: Bearer $API-Key' \ https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}` 说明您需要将示例中的`$API-Key`替换为您的百炼API-KEY。您需要将`{task_id}`替换为作业提交接口输出的`task_id`。
Authorization string 必选推荐使用百炼API-Key，也可填`DashScope API-Key`。例如：`Bearer d1xxx2a`。
URL路径参数（Path parameters）
task_id string 必选任务id。