图像背景生成API参考

模型效果示意

模型简介

图像模型处理时间较长，为了避免请求超时，HTTP调用仅支持异步获取模型结果。您需要发起两个请求：

1. 创建任务获取任务ID：首先发起创建任务请求，该请求会返回任务ID（task_id）。

2. 根据任务ID查询结果：使用上一步获得的任务ID，查询任务状态及结果。任务成功执行时将返回图像URL，有效期24小时。

边缘引导元素生成方法

边缘引导元素生成方法因其能够有效保留图像中的边缘和结构信息，在图像背景生成任务中常用于生成前景或背景元素图像。

步骤1：PS抠图，导出带透明背景的4通道格式图像。

步骤2：生成边缘引导元素图像。

针对步骤2，我们提供两种方案，任选一种即可。

方案一：ModelScope在线生成。

访问ModelScope背景图edge元素生成，直接上传第一步抠图后的图像点击运行即可获得符合要求的元素图像。

方案二：使用代码本地生成。

• 环境准备，Python环境中安装需要用到的依赖包。

pip install controlnet-aux==0.0.7

• 运行代码，使用如下Python脚本生成边缘引导元素。

import numpy as np
from PIL import Image
from controlnet_aux.processor import Processor

hed_processor = Processor('softedge_hed')


def make_elements(name):
    img=Image.open(name)
    img=np.array(img)
    img[:,:,:-1]=img[:,:,:-1]*(img[:,:,-1:]>127)
    img=Image.fromarray(img,mode='RGBA')
    r,g,b,a=img.split()
    img=Image.merge(mode='RGB',bands=[r,g,b])
    edge = hed_processor(img, to_pil=True).resize(img.size).convert('RGB')
    edge.putalpha(a)
    edge=np.array(edge)
    edge[:,:,:-1]=edge[:,:,:-1]*(edge[:,:,-1:]>50)
    edge=Image.fromarray(edge,mode='RGBA')
    edge.save('result.png')    

接口报错

wanx-background-generation-v3模型不存在

报错场景：如果您想切换V3模型，并将model参数设置为wanx-background-generation-v3，发送请求后发现报错，报错信息显示模型不存在。

{
    "code": "InvalidParameter",
    "message": "Model not exist.",
    "request_id": "539f3cf9-9b9c-9a0f-988f-1829c7eb502f"
}

原因及解决方案：目前图像背景生成只有wanx-background-generation-v2这一个模型。如果需要切换V3模型，请设置parameters.model_version为v3，才能成功调用v3模型。

使用文档中的示例图片报错提示需要提供RGBA模式的图片

报错场景：如果您将文档的示例图片下载到本地，重新上传到自己的存储服务器，并使用新的图片链接发起请求。请求后报错提示图像格式是RGB格式，而不是RGBA格式。

{
    "request_id": "8f7d6829-281a-9270-944b-xxxxxx",
    "output": {
        "task_id": "72a2d266-6822-4165-a6e4-xxxxxx",
        "task_status": "FAILED",
        "submit_time": "2024-11-07 09:51:19.xxx",
        "scheduled_time": "2024-11-07 09:51:19.xxx",
        "end_time": "2024-11-07 09:51:20.xxx",
        "code": "BadRequest.UnsupportedFileFormat",
        "message": "Base image require RGBA format, but is RGB, modes concept see https://pillow.readthedocs.io/en/stable/handbook/concepts.html#concept-modes"
    },
    "usage": {
        "image_count": 0
    }
}

主要原因：存在主体图像、前景元素图像或背景元素图像不是RGBA图像的情况。在从文档示例链接下载图片至本地并再上传至存储服务的过程中，这些环节可能会改变原始的RGBA图像。可能出现的情况包括：图片下载至本地时保存的格式不支持透明度，例如.jpg、.jpeg等；上传至存储服务器时不支持RGBA格式；在使用工具进行图像编辑或转换时，未能保留图像透明度等。

解决方案：请参见如何查看并获取RGBA图像。