图像擦除补全

图像擦除补全 — 创建任务

异步提交图像擦除补全任务

POST

/services/aigc/image2image/image-synthesis

curl

curl --location --request POST 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "image-erase-completion",
    "input": {
            "image_url": "http://xxx/input.png",
            "mask_url": "http://xxx/mask.png",
            "foreground_url": "http://xxx/foreground.png"
        },
    "parameters":{
        "dilate_flag":true
    }
}'

{
  "output": {
    "task_status": "PENDING",
    "task_id": "53950fb7-281a-4e60-b543-xxxxxxxxxxxx"
  },
  "request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51"
}

鉴权

string

header

必填

千问云 API Key。详见获取 API Key。

Header 参数

enum<string>

默认值"enable"

必填

必须设置为 enable，表示使用异步方式提交任务。

可选值：enable

请求体

application/json

enum<string>

必填

模型名称，固定值为 image-erase-completion。

可选值：image-erase-completion

object

必填

显示子属性

string

必填

待擦除处理的输入图片的URL链接。图片格式支持JPEG、PNG、JPG、BMP、WEBP，图片分辨率在512×512~4096×4096之间，文件大小不超过10MB。

string

必填

蒙版图片的URL链接。蒙版区域为白色，保留区域为黑色。图片格式支持JPEG、PNG、JPG、BMP、WEBP，图片分辨率在512×512~4096×4096之间，文件大小不超过10MB。

string

前景图片的URL链接。指定前景，可避免擦除结果改变前景。图片格式支持JPEG、PNG、JPG、BMP、WEBP，图片分辨率在512×512~4096×4096之间，文件大小不超过10MB。

object

显示子属性

boolean

默认值false

是否使用快速模式，开启后可加快推理速度。默认值为false。

boolean

默认值true

是否使用mask扩展功能。开启后，将对mask进行自动扩展来增强擦除效果。默认值为true。

boolean

默认值true

是否添加水印。默认值为true。添加的水印不影响图像质量。

响应

200-application/json

string

请求唯一标识。

object

显示子属性

string

任务ID，用于后续查询任务状态和结果。

enum<string>

任务状态，提交成功时为 PENDING。

可选值：PENDING

curl

curl --location --request POST 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "image-erase-completion",
    "input": {
            "image_url": "http://xxx/input.png",
            "mask_url": "http://xxx/mask.png",
            "foreground_url": "http://xxx/foreground.png"
        },
    "parameters":{
        "dilate_flag":true
    }
}'

{
  "output": {
    "task_status": "PENDING",
    "task_id": "53950fb7-281a-4e60-b543-xxxxxxxxxxxx"
  },
  "request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51"
}