# 图片编辑
创建图片编辑任务
# 功能介绍
图片智能编辑功能是一项突破性的技术,允许您仅通过简单的文字描述,就能对单张或多张图片进行深度且富有创意的修改。
您只需输入自然语言指令(Prompt),算法即可智能理解并执行从内容重构(如添加、移除或替换物体)、风格转换(如油画风、赛博朋克),到画质增强、场景迁移等全方位编辑。它结合多张参考图的视觉元素,实现精准的风格融合与细节控制,将您的想象快速转化为视觉现实。
无论是专业设计师进行创意探索,还是普通用户美化生活照片,这一功能都极大地降低了专业编辑门槛,让每个人都能轻松实现从照片修复到艺术创作的无限可能。
# API说明
# 创建图片编辑任务
# 接口描述
根据用户上传的指定内容调用算法能力进行图片编辑,最终返回png文件供用户下载。PaaS平台支持7天在线存储,需要及时转存,7天后生成内容将无法下载。
# 请求地址
POST
/api/2dvh/v1/material/single/image/edit
# 请求头
Content-Type:
application/json
# 请求参数
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
imageName | String | True | 图片名称 |
param | String | True | 创建图片编辑任务需要传入正确的param信息,其中包括各类图片编辑参数(该参数为json转义后的字符串) |
# 请求样例
{
"imageName": "xxx",
"param": "{\"images\":[\"https://dhs.blob.core.chinacloudapi.cn/share/i2v_test/33166f5a2c6b54aed18a1fb313bd04b9_20251224144112209.jpeg\",\"https://dwg-aigc-paas-prod.tos-cn-shanghai.volces.com/user-upload/506/8ddd8fe1d7de6f51223104b656a80963_20251224141011387.jpeg\",\"https://dhs.blob.core.chinacloudapi.cn/share/i2v_test/442948967-%E5%90%AC%E5%8F%8B44294896.jpg\"],\"prompt\":\"图一和图二中的两个小女孩并排站着,牵着图三的小狗\",\"watermark\":{\"show\":true,\"content\":\"AI生成\"}}"
}
# 响应元素
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
code | Integer | True | 0 - 成功, 其他 - 异常 |
message | String | True | 异常详细信息 |
data | Integer | False | 任务id |
# 响应样例
{
"code": 0,
"message": "success",
"data": 1
}
# json参数说明
| 名称 | 类型 | 取值示例 | 必填 | 说明 |
|---|---|---|---|---|
| images | string[] | 是 | 输入图片的 URL 列表,支持 1~3 张图片;单张图片分辨率不超过 2K,文件大小不超过 10MB | |
| prompt | string | 是 | 文本提示词,用于描述生成或编辑图片的内容 | |
| resolution | int[] | 否 | 输出图片分辨率,格式为 [width, height],宽高均不超过 2K,默认为输入的第一张图片分辨率 | |
| watermark | object | 否 | 图片水印配置 | |
| └─ show | boolean | 否 | 是否显示图片水印 | |
| └─ content | string | 否 | 水印内容;当 show=true 且未填写时,系统将自动生成默认水印内容 |
{
"images": ["https://dhs.blob.core.chinacloudapi.cn/share/i2v_test/33166f5a2c6b54aed18a1fb313bd04b9_20251224144112209.jpeg", "https://dwg-aigc-paas-prod.tos-cn-shanghai.volces.com/user-upload/506/8ddd8fe1d7de6f51223104b656a80963_20251224141011387.jpeg", "https://dhs.blob.core.chinacloudapi.cn/share/i2v_test/442948967-%E5%90%AC%E5%8F%8B44294896.jpg"],
"prompt": "图一和图二中的两个小女孩并排站着,牵着图三的小狗",
"watermark": {
"show": true,
"content": "AI生成"
}
}
以上即为平台可以提供的全部图片编辑能力。