场景图生成任务提交API调用说明
场景图生成任务提交
POST
/ai/image/background/generation/scenario
基于传入的场景ID,自动从图片中提取商品主体,生成各种不同场景风格的高质量产品图像。背景图生成是异步生成方式。该API是提交生成任务;如需获取生成结果,请调用结果查询接口。
请求参数
参数 | 类型 | 必填 | 参数描述及示例值 |
---|---|---|---|
| Object[] | 是 | 请求参数 |
| String | 否 | 商品图片URL。 与 图片尺寸应该大于512*512像素,小于3000*3000像素。 |
| String | 否 | 商品图片的Base64编码。 跟imageUrl不能同时为空。如果同时存在imageUrl和imageBase64,优先取 Base64。 图片尺寸应该大于512*512像素,小于3000*3000像素。 |
| String | 否 | 需要生成的场景编号。场景编号的查询请使用“场景图背景模板推荐与查询”接口。 |
| Boolean | 否 | 是否需要对商品进行重新布局。 取值范围: true:对商品位置进行重新布局 false:使用传入图片的商品位置,不进行重新布局。
|
| String | 否 | 商品标题。 如果不需要自动布局,则无需传入。 仅支持中文或英文的商品标题。 |
| Number | 是 | 期望生成的图片宽度。 单位:像素。 目前仅支持生成1:1(宽800*高800)和3:4(宽750*高1000)的尺寸。
|
| Number | 是 | 期望生成的图片高度。 单位:像素。 目前仅支持生成1:1(宽800高800)和3:4(宽750高1000)的尺寸。
|
| Number | 是 | 期望生成的图片数量。 单次任务最少生成2张,最多生成10张。如果不设置,默认生成4张。 取值范围:2-10
|
请求示例
以下是对应图片输入限制:
图像格式:JPEG、JPG、PNG、BMP、WEBP。
图像大小:不超过 4 MB。
图像分辨率:输入图片尺寸大于 512×512 像素,小于 3000×3000 像素。
响应参数
参数 | 类型 | 描述 | |
---|---|---|---|
| Number | 返回的结果码,其中200代表成功,详细错误码请参考错误码列表。 | |
| String | 唯一的请求ID。用于排查问题。 | |
| Boolean | 返回的请求状态,代表请求是否成功。 | |
| String | 返回的请求信息。 | |
| Object | 返回的json结果数据。 | |
| Object | 返回的结果数据。 | |
| String | 唯一的任务ID。用于后续的请求结果查询。 |
响应示例
错误码
错误码 | 错误信息 | 描述 |
---|---|---|
500 | system error | 服务器内部错误 |
501 | rate limit exceed | 当前接口已达到限流上限,请搜索Aidge产品咨询&服务群钉钉群号:105455001046,入群联系我们增加当前限制值。 |
700 | invalid input | 输入参数的格式不符合要求,resMessage 将返回详细的不符合要求的字段。 |
801 | model failed | 内部调用异常,请搜索Aidge产品咨询&服务群钉钉群号:105455001046,入群联系我们进行故障排除。 |
1000 | content has sensitive data, please try other input | 内容包含敏感数据,无法处理,请尝试其他输入。 |
1001 | content control failed, please retry | 风控服务运行异常,请搜索Aidge产品咨询&服务群钉钉群号:105455001046,入群联系我们。 |
1002 | content risk filter failed, please contact us | 风控服务运行异常,请搜索Aidge产品咨询&服务群钉钉群号:105455001046,入群联系我们。 |
Last updated