一、前提条件
在使用本功能前,你需完成以下前置操作:
·腾讯云账号注册/登录、开通 MPS 产品、完成服务角色授权。
·若你使用腾讯云子账号,还需要保证账号有足够权限使用 MPS 产品。
具体指引请参考 快速入门。账号授权问题可参考 账号授权 文档。
二、计费说明
参考计费说明文档。
三、创建图片增强任务
调用 ProcessImage 接口,选择 EnhanceConfig 任务,参数详细填写说明请参考 ImageEnhanceConfig 参数。
四、示例1: 发起通用增强任务
{ "InputInfo": {//输入图片路径,请替换为你的原始图片 "Type": "URL", "UrlInputInfo": { "Url": "https://test-1234567.cos.ap-guangzhou.myqcloud.com/photo/test.png" } }, "OutputStorage": {//输出COS存储桶,请替换 "Type": "COS", "CosOutputStorage": { "Bucket": "test-1234567", "Region": "ap-guangzhou" } }, "OutputDir": "/share/output/", "ImageTask": { "EnhanceConfig": {//图片增强参数设置 "ImageQualityEnhance": {//综合增强 "Type": "strong"//该参数示例为高清增强。更多综合增强可选值见下方表格。 }, } }}
综合增强 type 参数可选值:
| 增强能力 | Type 参数 |
| 低清增强 | weak |
| 标清增强 | normal |
| 高清增强 | strong |
五、示例2:发起图片高级超分任务
发起高级超分任务,参数详细填写说明请参考 AdvancedSuperResolutionConfig 参数 。
{ "Action": "ProcessImage", "InputInfo": {//输入图片路径,请替换为你的原始图片 "Type": "URL", "UrlInputInfo": { "Url": "https://test-1234567.cos.ap-guangzhou.myqcloud.com/photo/test.png" } }, "OutputStorage": {//输出COS存储桶,请替换 "Type": "COS", "CosOutputStorage": { "Bucket": "test-1234567", "Region": "ap-guangzhou" } }, "OutputDir": "share/output/", "ImageTask": { "EncodeConfig": { "Format": "JPEG", "Quality": 80 }, "EnhanceConfig": { "AdvancedSuperResolutionConfig": {//图片超分配置 "Switch": "ON", "Type": "ultra", "Mode": "percent", "Percent": 1.5//超分倍率设置为1.5,你可以按需修改 } } }}
处理效果示例:
也建议你通过 API Explorer 实现快速验证,选择“媒体处理”产品,在左侧接口列表选择 发起图片处理 接口。你可以将上述 JSON 复制到 API Explorer 的 JSON 模式中,切换至“表单”模式可以自动解析,调整输入输出路径等必要参数后,再单击发起调用即可。
六、调用接口查询任务结果
在使用 ProcessImage 发起媒体处理任务后,会返回任务 ID(TaskId),例如:24000022-WorkflowTask-b20a8exxxxxxx1tt110253、24000022-ScheduleTask-774f101xxxxxxx1tt110253。调用 DescribeImageTaskDetail 接口,输入任务 ID 即可获取任务结果,你需要解析 ImageProcessTaskResultSet 字段获取任务结果。