潮际主设标准API文档
任务接口
获取OSS文件上传签名信息
基本信息
Path： /sas/oss/get_oss_secret
Method： GET
接口描述：
apiName: sas_oss_get_oss_secret_fileType
appKey: super-asigner-server
阿里云oss 服务端签名后直传文档：
https://help.aliyun.com/document_detail/31926.html
上传大小限制为：5M
本地文件上传oss demo
// 将base64转换为文件
function dataURLtoFile(dataurl, filename) {
const arr = dataurl.split(',')
const mime = arr[0].match(/:(.*?);/)[1]
const bstr = atob(arr[1])
let n = bstr.length
const u8arr = new Uint8Array(n)
while (n--) {
u8arr[n] = bstr.charCodeAt(n)
}
return new File([u8arr], filename, { type: mime })
}
export const uploadToOss = async (base64Data: string, imgName: string) => {
// 调用
const file = dataURLtoFile(base64Data, imgName)
//dir、accessid、policy、signature 字段信息从 获取OSS文件上传签名信息 接口获取
try {
const { data } = await requestOssInfo(FILE_TYPE.IMAGE)
const path = data.dir + imgName
const formData = new FormData()
//imgName 图片名称自定义即可
formData.append('key', data.dir + imgName)
formData.append('OSSAccessKeyId', data.accessid)
formData.append('policy', data.policy)
formData.append('Signature', data.signature)
formData.append('success_action_status', '200')
formData.append('file', file)
try {
await request<Http.Res>(data.host, {
method: 'POST',
data: formData
})
} catch (err) {}
return path
} catch (e) {}
}
请求参数
Query
| 参数名称 | 是否必须 | 示例 | 备注 |
|---|---|---|---|
| fileType | 是 | 1 | 上传文件类型 （1-图片、2-视频、3-音频、4-excel、＞4-其它） |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 非必须 | |||
| message | string | 非必须 | |||
| data | object | 非必须 | |||
| ├─ accessid | string | 非必须 | |||
| ├─ host | string | 非必须 | |||
| ├─ policy | string | 非必须 | |||
| ├─ signature | string | 非必须 | |||
| ├─ expire | integer | 非必须 | |||
| ├─ dir | string | 非必须 | |||
| requestId | string | 非必须 |
异步API任务调用-任务结果查询
基本信息
Path： /sas/my_creation/query_one
Method： GET
接口描述：
描述
调通过异步的算法服务接口返回的任务id查询任务结果。
status 枚举值： 1. 处理中 2:成功 3.失败 5.离线待调度 6.部分失败7.排队中
说明
api_name: sas_my_creation_query_one_id
appKey: super-asigner-server
请求参数
Query
| 参数名称 | 是否必须 | 示例 | 备注 |
|---|---|---|---|
| id | 否 | 任务id |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 非必须 | |||
| message | string | 非必须 | |||
| data | object | 非必须 | |||
| ├─ sasMyCreationPicVOs | object [] | 非必须 | item 类型: object | ||
| ├─ picUrl | string | 非必须 | 图片链接 | ||
| ├─ name | string | 必须 | 名称 | ||
| ├─ myCreationId | integer | 非必须 | 创建ID | ||
| ├─ picSize | integer | 非必须 | 图片大小 | ||
| ├─ picPath | string | 必须 | 图片路径 | ||
| ├─ remark | string | 非必须 | 描述 | ||
| ├─ id | integer | 非必须 | |||
| ├─ status | integer | 非必须 | |||
| ├─ createBy | string | 非必须 | |||
| ├─ createTime | string | 非必须 | mock: @datetime("yyyy-MM-dd HH:mm:ss") | ||
| ├─ updateBy | string | 非必须 | |||
| ├─ updateTime | string | 非必须 | mock: @datetime("yyyy-MM-dd HH:mm:ss") | ||
| ├─ orgCode | string | 非必须 | |||
| ├─ name | string | 必须 | 名称 | ||
| ├─ requestId | string | 非必须 | 唯一请求编号 | ||
| ├─ errorMsg | string | 非必须 | 错误消息。 | ||
| ├─ remark | string | 非必须 | 备注 | ||
| ├─ id | integer | 非必须 | |||
| ├─ status | integer | 非必须 | |||
| ├─ createBy | string | 非必须 | |||
| ├─ createTime | string | 非必须 | mock: @datetime("yyyy-MM-dd HH:mm:ss") | ||
| ├─ updateBy | string | 非必须 | |||
| ├─ updateTime | string | 非必须 | mock: @datetime("yyyy-MM-dd HH:mm:ss") | ||
| requestId | string | 非必须 |
批量取消任务
基本信息
Path： /sas/my_creation/batch_cancel_tasks
Method： POST
接口描述：
描述
调通过id批量取消任务，只允许排队中(状态为：7)的任务
status 枚举值： 1. 处理中 2:成功 3.失败 5.离线待调度 6.部分失败7.排队中
说明
apiName: sas_my_creation_batch_cancel_tasks
appkey： super-asigner-server
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 |
Query
| 参数名称 | 是否必须 | 示例 | 备注 |
|---|---|---|---|
| startPicId | 否 | picId起始值，用于增量查询图片 |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| number [] | 非必须 | item 类型: number | |||
| ├─ | 非必须 | 任务id列表，最多支持100条 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 非必须 | 响应码 | ||
| message | string | 非必须 | 相应消息 | ||
| data | integer | 非必须 | 请求结果 | ||
| requestId | string | 非必须 | 请求id |
款式
款式创新
基本信息
Path： /sas/algorithm/imageToImage
Method： POST
接口描述：
功能描述
根据用户上传的款式图，生成创新款式
使用说明
调用者必须首先提供款式图，之后可以选择上传的款式图的“category（品类）”和“material（材质）”，以及想要创新的“风格”，在结合基本款式的同时自动生成各种创新款式和配色方案。
图片要求
图片格式：'.JPG', '.PNG', '.JPEG', '.BMP', '.WEBP'
图片大小：不超过5MB
接口说明
apiName: sas_algorithm_imageToImage
appKey: super-asigner-server
接口为异步接口，需要异步获取，点击跳转至异步API任务调用取
功能示例
1.上传款式图 2.确定款式基本信息
3.生成结果
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| image | string | 必须 | 参考图 oss path | ||
| rootCategory | string | 必须 | 一级分类：WOMAN(女装) 、MAN（男装）、CHILDREN（童装）、LUGGAGE（箱包）、SHOES（鞋靴）、HOME（内衣）传值例如：WOMAN | mock: WOMAN | |
| mode | string | 必须 | 生成模式 可选:'normal', 'color','clothes_sdxl','renewal'；默认'normal'，需要使用随机换色时传'color'，服饰新模型传'clothes_sdxl' ，鞋靴新模型：renewal | ||
| text | string | 非必须 | 风格文本："学院","甜美","田园","侘寂","暗黑","解构","街头","艺术","韩系","日系","法式"。（女装为例，详见“参数说明”） | ||
| attr | string | 非必须 | 元素词，目前仅支持新中式、传统中式风格 | ||
| batch_size | integer | 非必须 | 1 | 生成图片数量 [1, 8]区间整数，默认8 | |
| resolution | integer | 非必须 | 1024 | 生成图片尺寸 512, 768, 1024，默认1024 | |
| id | integer | 非必须 | 创建ID | ||
| name | string | 非必须 | 名称，默认使用UUID;不可重复 | ||
| category | string | 非必须 | 上传款式图的品类词："衬衫","T恤","针织衫","卫衣","背心","打底衫","罩衫","毛衣","吊带"。（女装为例，详见“参数说明”） | 枚举备注: 未选择时，将由AI进行随机创作 | |
| material | string | 非必须 | 上传款式图的材质词："棉","麻","真丝","毛/绒","皮","人造纤维","混纺","皮草","细纱线"。（女装为例，详见“参数说明”） | 枚举备注: 未选择时，将由AI进行随机创作 | |
| businessKey | integer | 非必须 | 业务字段，业务方可以自定义 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 非必须 | 响应编码，若成功请求为2000 | ||
| message | string | 非必须 | 响应消息，若成功请求为 success | ||
| data | integer | 非必须 | 该值为任务ID。在“异步任务API调用”中，通过传入该值，得到生成结果 | 枚举备注: | |
| requestId | string | 非必须 | 请求id |
趋势延伸
基本信息
Path： /sas/algorithm/trend_image_to_image_flux
Method： POST
接口描述：
功能描述
【趋势延伸】属于款式创新下的子模型，上传款式图后，用户可以选择一个趋势点，例如：裤筒开叉，【趋势延伸】模型会自动将该趋势精巧融合进原款式中，创造出既紧跟潮流又不失品牌调性的全新设计。与“大幅创新”“渐进改良”模型相比，【趋势延伸】在创新的同时，更精准地保留服装原本的风格，确保设计语言的一致性，在服装结构合理性上有所提升，并修复了人像面部及手脚扭曲残缺问题，真正做到“在对的基础上变得更好”。
使用说明
调用者必须首先提供款式图，之后可以选择想要结合的趋势点，该模型目前只支持女装（WOMEN）品类
图片要求
图片格式：'.JPG', '.PNG', '.JPEG', '.BMP', '.WEBP'
图片大小：不超过20MB
接口说明
apiName: sas_algorithm_trend_image_to_image_flux
appKey: super-asigner-server
接口为异步接口，需要异步获取，点击跳转至异步API任务调用取
功能示例
1.上传款式图
2.选择趋势点
3.生成结果图
curl 调用示例
curl --location --request POST 'https://open.metac-inc.com/api'
--header 'requestId: xxxx'
--header 'accessKey: xxxx'
--header 'apiName: sas_algorithm_trend_image_to_image_flux'
--header 'appKey: super-asigner-server'
--header 'timestamp: xxxxx'
--header 'sign: xxxx'
--header 'Content-Type: application/json'
--data-raw '{
"image": "xxxxxx",
"trend": "垂坠腰头"
}'
返回格式
{
"requestId": "xxxx",
"code": 2000,
"message": "success",
"data": 123,
"succ": true
}
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| image | string | 必须 | 参考图 oss path | ||
| trend | string | 必须 | 趋势点 | ||
| seed | long | 非必须 | 生成种子，默认-1，完全随机 | ||
| rootCategory | string | 非必须 | rootCategory，目前只支持WOMAN | mock: WOMAN | |
| batch_size | integer | 非必须 | 1 | 生成图片数量 [4, 8]区间整数，默认4 | |
| resolution | integer | 非必须 | 1024 | 生成图片尺寸 512, 768, 1024，默认1024 | |
| businessKey | integer | 非必须 | 业务字段，业务方可以自定义 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 非必须 | 响应编码，若成功请求为2000 | ||
| message | string | 非必须 | 响应消息，若成功请求为 success | ||
| data | integer | 非必须 | 该值为任务ID。在“异步任务API调用”中，通过传入该值，得到生成结果 | 枚举备注: | |
| requestId | string | 非必须 | 请求id |
灵感实验室
基本信息
Path： /sas/algorithm/inspirationToImage
Method： POST
接口描述：
功能描述
根据用户上传的商品和灵感参考图，可以在原商品图的基础上，融合灵感参考图的部分元素，生成新的创意设计稿，为设计师提供设计创意灵感。
使用说明
调用者需要提供款式图和灵感图。之后可以选择款式图的“category（品类）”和“material（材质）”，以及想要创新的“风格”，在款式图的基础数，结合灵感图自动生成各种创新款式和配色方案。
图片要求
图片格式：'.JPG', '.PNG', '.JPEG', '.BMP', '.WEBP'
图片大小：不超过5MB
接口说明
apiName: sas_algorithm_inspirationToImage
appKey: super-asigner-server
接口为异步，结果需要异步获取点击跳转至异步API任务调用
功能示例
（1）操作流程
1.上传款式图 2.上传灵感图 3.确定款式信息
4.生成结果(模型A)
（2）模型对比
1.原图 2.灵感图
3.模型A
- 模型B
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| image | string | 必须 | 款式图 oss path | ||
| inspiration_image | string | 必须 | 灵感图 oss path | ||
| mode | string | 非必须 | abstract | 灵感生成模式：'abstract'，'element'二选一 | |
| rootCategory | string | 非必须 | 一级分类：WOMAN(女装) 、MAN（男装）、CHILDREN（童装）、LUGGAGE（箱包）、SHOES（鞋靴）、HOME（内衣）传值例如：WOMAN | ||
| text | string | 非必须 | 空字符串 | 风格文本："学院","甜美","田园","侘寂","暗黑","解构","街头","艺术","韩系","日系","法式"。（女装为例，详见“参数说明”） | |
| diversity | number | 非必须 | 0.5 | 多样性 [0, 1]区间浮点数，默认0.5 创新程度： 0.3 , 0.6, 0.9 | 枚举备注: 调整生成图像的多样性。值越高，生成结果的多样性越高，但同时准确性和质量有可能越低 |
| batch_size | integer | 非必须 | 生成图片数量 [1, 8]区间整数，默认8 | ||
| resolution | integer | 非必须 | 1024 | 生成图片尺寸 512, 768, 1024，默认1024 | |
| id | integer | 非必须 | 创建ID | ||
| name | string | 非必须 | 名称，默认使用UUID;不可重复 | ||
| category | string | 必须 | 款式图的品类词："衬衫","T恤","针织衫","卫衣","背心","打底衫","罩衫","毛衣","吊带"。（女装为例，详见“参数说明”） | 枚举备注: 未选择时，将由AI进行随机创作 | |
| material | string | 非必须 | 款式图的材质词："棉","麻","真丝","毛/绒","皮","人造纤维","混纺","皮草","细纱线"。（女装为例，详见“参数说明”） | 枚举备注: 未选择时，将由AI进行随机创作 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 非必须 | |||
| message | string | 非必须 | |||
| data | integer | 非必须 | 该值为任务ID。在“异步任务API调用”中，通过传入该值，得到生成结果 | ||
| requestId | string | 非必须 |
替换融合
基本信息
Path： /sas/algorithm/imageMerge
Method： POST
接口描述：
功能描述
根据用户上传的服装和融合参考图，可以在原服装的款式基础上，结合融合参考图的颜色、风格、细节，生成全新的服装设计图，为设计师提供设计灵感。
使用说明
调用者需要提供款式图和融合参考图。之后可以选择上传的款式图的“category（品类）”和“material（材质）”，以及想要创新的“text(风格文本)”，在结合基本款式的同时自动生成各种创新款式和配色方案。
图片要求
图片格式：'.JPG', '.PNG', '.JPEG', '.BMP', '.WEBP'
图片大小：不超过5MB
接口说明
apiName: sas_algorithm_imageMerge
appKey: super-asigner-server
接口为异步，需要异步获取，点击跳转至异步API任务调用
功能示例
1.上传款式图 2.上传灵感图 3.确定款式信息
4.生成结果
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| image1 | string | 必须 | 基本款式图 oss path | ||
| image2 | string | 必须 | 融合参考图 oss path | ||
| ratio | number | 非必须 | 0.5 | 融合比例 [0, 1]区间浮点数，默认0.5；output = (1 - ratio) * input1 + ratio * input2； | |
| mode | string | 非必须 | 经典模型：classic： 焕新模型：renewal，rootCategory为鞋子时生效 | ||
| rootCategory | string | 非必须 | 一级分类：WOMAN(女装) 、MAN（男装）、CHILDREN（童装）、LUGGAGE（箱包）、SHOES（鞋靴）、HOME（内衣）传值例如：WOMAN | ||
| text | string | 非必须 | 空字符串 | 风格文本："学院","甜美","田园","侘寂","暗黑","解构","街头","艺术","韩系","日系","法式"。（女装为例，详见“参数说明”） | |
| diversity | number | 非必须 | 0.5 | 多样性 [0, 1]区间浮点数 创新程度： 0.3 , 0.6, 0.9 | 枚举备注: 调整生成图像的多样性。值越高，生成结果的多样性越高，但同时准确性和质量有可能越低 |
| batch_size | integer | 非必须 | 8 | 生成图片数量 [1, 8]区间整数 | |
| resolution | integer | 非必须 | 1024 | 生成图片尺寸 512, 768, 1024 | |
| id | integer | 非必须 | 创建ID | ||
| name | string | 非必须 | 名称，默认使用UUID;不可重复 | ||
| category | string | 非必须 | 上传款式图的品类词："衬衫","T恤","针织衫","卫衣","背心","打底衫","罩衫","毛衣","吊带"。（女装为例，详见“参数说明”） | 枚举备注: 未选择时，将由AI进行随机创作 | |
| material | string | 非必须 | 上传款式图的材质词："棉","麻","真丝","毛/绒","皮","人造纤维","混纺","皮草","细纱线"。（女装为例，详见“参数说明”） | 枚举备注: 未选择时，将由AI进行随机创作 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 非必须 | |||
| message | string | 非必须 | |||
| data | integer | 非必须 | 该值为任务ID。在“异步任务API调用”中，通过传入该值，得到生成结果 | ||
| requestId | string | 非必须 |
线稿成款
基本信息
Path： /sas/algorithm/image_from_line
Method： POST
接口描述：
功能描述
根据用户上传的服装线稿图，生成多种颜色、风格、面料的效果图
使用说明
调用者需要提供线稿图。之后可以选择指定的“category（品类）”和“material（材质）”，以及想要的“风格”。可以选择是否使用原稿颜色（use_ori_color），还可以选择确定或随机的颜色。之后AI依据这些输入条件，自动生成各种配色的线稿效果图。
图片要求
图片格式：'.JPG', '.PNG', '.JPEG', '.BMP', '.WEBP'
图片大小：不超过5MB
接口说明
api_name: sas_algorithm_image_from_line
appKey: super-asigner-server
接口为异步，结果需要异步获取，点击跳转至异步API任务调用
功能示例
1.上传线稿图 2.确定款式信息
3.生成结果
颜色说明
| 名称 | 英语 | 十六进制 |
| 黑色 | Black | #000000 |
| 昏灰 | Dimgray | #696969 |
| 灰色 | Gray | #808080 |
| 暗灰 | Dark Gray | #A9A9A9 |
| 银色 | Silver | #C0C0C0 |
| 亮灰色 | Light Gray | #D3D3D3 |
| 庚斯博罗灰 | Gainsboro | #DCDCDC |
| 白烟色 | White Smoke | #F5F5F5 |
| 白色 | White | #FFFFFF |
| 雪色 | Snow | #FFFAFA |
| 沙棕 | Sand Beige | #E6C3C3 |
| 玫瑰褐 | Rosy Brown | #BC8F8F |
| 亮珊瑚色 | Light Coral | #F08080 |
| 印度红 | Indian Red | #CD5C5C |
| 褐色 | Brown | #A52A2A |
| 耐火砖红 | Fire Brick | #B22222 |
| 栗色 | Maroon | #800000 |
| 暗红 | Dark Red | #8B0000 |
| 鲜红 | Strong Red | #E60000 |
| 红色 | Red | #FF0000 |
| 柿子橙 | Persimmon | #FF4D40 |
| 雾玫瑰色 | MistyRose | #FFE4E1 |
| 鲑红 | Salmon | #FA8072 |
| 腥红 | Scarlet | #FF2400 |
| 番茄红 | Tomato | #FF6347 |
| 暗鲑红 | Dark Salmon | #E9967A |
| 珊瑚红 | Coral | #FF7F50 |
| 橙红 | Orange Red | #FF4500 |
| 亮鲑红 | Light Salmon | #FFA07A |
| 朱红 | Vermilion | #FF4D00 |
| 黄土赭 | Sienna | #A0522D |
| 热带橙 | Tropical Orange | #FF8033 |
| 驼色 | Camel | #A16B47 |
| 查黄 | Apricot | #E69966 |
| 椰褐 | Coconut Brown | #4D1F00 |
| 海贝色 | Seashell | #FFF5EE |
| 鞍褐 | Saddle Brown | #8B4513 |
| 巧克力色 | Chocolate | #D2691E |
| 燃橙 | Burnt Orange | #CC5500 |
| 阳橙 | Sun Orange | #FF7300 |
| 粉扑桃色 | Peach Puff | #FFDAB9 |
| 沙褐 | Sand Brown | #F4A460 |
| 古铜色 | Bronze | #B87333 |
| 亚麻色 | Linen | #FAF0E6 |
| 蜜橙 | Honey Orange | #FFB366 |
| 秘鲁色 | Peru | #CD853F |
| 乌贼墨色 | Sepia | #704214 |
| 赭色 | Ocher | #CC7722 |
| 陶坯黄 | Bisque | #FFE4C4 |
| 橘色 | Tangerine | #F28500 |
| 暗橙 | Dark Orange | #FF8C00 |
| 古董白 | Antique White | #FAEBD7 |
| 日晒色 | Tan | #D2B48C |
| 硬木色 | Burly Wood | #DEB887 |
| 杏仁白 | Blanched Almond | #FFEBCD |
| 那瓦霍白 | Navajo White | #FFDEAD |
| 万寿菊黄 | Marigold | #FF9900 |
| 番木瓜色 | Papaya Whip | #FFEFD5 |
| 灰土色 | Pale Ocre | #CCB38C |
| 卡其色 | Khaki | #996B1F |
| 鹿皮鞋色 | Moccasin | #FFE4B5 |
| 旧蕾丝色 | Old Lace | #FDF5E6 |
| 小麦色 | Wheat | #F5DEB3 |
| 桃色 | Peach | #FFE5B4 |
| 橙色 | Orange | #FFA500 |
| 花卉白 | Floral White | #FFFAF0 |
| 金菊色 | Goldenrod | #DAA520 |
| 暗金菊色 | Dark Goldenrod | #B8860B |
| 咖啡色 | Coffee | #4D3900 |
| 茉莉黄 | Jasmine | #E6C35C |
| 琥珀色 | Amber | #FFBF00 |
| 玉米丝色 | Cornsilk | #FFF8DC |
| 铬黄 | Chrome Yellow | #E6B800 |
| 金色 | Golden | #FFD700 |
| 柠檬绸色 | Lemon Chiffon | #FFFACD |
| 亮卡其色 | Light Khaki | #F0E68C |
| 灰金菊色 | Pale Goldenrod | #EEE8AA |
| 暗卡其色 | Dark Khaki | #BDB76B |
| 含羞草黄 | Mimosa | #E6D933 |
| 奶油色 | Cream | #FFFDD0 |
| 象牙色 | Ivory | #FFFFF0 |
| 米黄色 | Beige | #F5F5DC |
| 亮黄 | Light Yellow | #FFFFE0 |
| 亮金菊黄 | Light Goldenrod Yellow | #FAFAD2 |
| 香槟黄 | Champagne Yellow | #FFFF99 |
| 芥末黄 | Mustard | #CCCC4D |
| 月黄 | Moon Yellow | #FFFF4D |
| 橄榄色 | Olive | #808000 |
| 鲜黄 | Canary Yellow | #FFFF00 |
| 黄色 | Yellow | #FFFF00 |
| 苔藓绿 | Moss Green | #697723 |
| 亮柠檬绿 | Light Lime | #CCFF00 |
| 橄榄军服绿 | Olive Drab | #6B8E23 |
| 黄绿 | Yellow Green | #9ACD32 |
| 暗橄榄绿 | Dark 0live Green | #556B2F |
| 苹果绿 | Apple Green | #8CE600 |
| 绿黄 | Green Yellow | #ADFF2F |
| 草绿 | Grass Green | #99E64D |
| 草坪绿 | Lawn Green | #7CFC00 |
| 查特酒绿 | Chartreuse | #7FFF00 |
| 叶绿 | Foliage Green | #73B839 |
| 嫩绿 | Fresh Leaves | #99FF4D |
| 明绿 | Bright Green | #66FF00 |
| 钴绿 | Cobalt Green | #66FF59 |
| 蜜瓜绿 | Honeydew | #F0FFF0 |
| 暗海绿 | Dark Sea Green | #8FBC8F |
| 亮绿 | Light Green | #90EE90 |
| 灰绿 | Pale Green | #98FB98 |
| 常春藤绿 | Ivy Green | #36BF36 |
| 森林绿 | Forest Green | #228B22 |
| 暗绿 | Dark Green | #006400 |
| 绿色 | Green | #008000 |
| 柠檬绿 | Lime | #00FF00 |
| 孔雀石绿 | Malachite | #22C32E |
| 薄荷绿 | Mint | #16982B |
| 青瓷绿 | Celadon Green | #73E68C |
| 碧绿 | Emerald | #50C878 |
| 绿松石绿 | Turquoise Green | #4DE680 |
| 铬绿 | Veridian | #127436 |
| 苍色 | Horizon Blue | #A6FFCC |
| 海绿 | Sea Green | #2E8B57 |
| 中海绿 | Medium Sea Green | #3CB371 |
| 薄荷奶油色 | Mint Cream | #F5FFFA |
| 春绿 | Spring Green | #00FF80 |
| 孔雀绿 | Peacock Green | #00A15C |
| 中春绿色 | Medium Spring Green | #00FA9A |
| 中碧蓝色 | Medium Aquamarine | #66CDAA |
| 碧蓝色 | Aquamarine | #7FFFD4 |
| 青蓝 | Cyan Blue | #0DBF8C |
| 水蓝 | AquaBlue | #66FFE6 |
| 绿松石蓝 | Turquoise Blue | #33E6CC |
| 绿松石色 | Turquoise | #30D5C8 |
| 亮海绿 | Light Sea Green | #20B2AA |
| 中绿松石色 | MediumTurquoise | #48D1CC |
| 亮青 | Light Cyan | #E0FFFF |
| 浅蓝 | BabyBlue | #E0FFFF |
| 灰绿松石色 | Pale Turquoise | #AFEEEE |
| 暗岩灰 | Dark Slate Gray | #2F4F4F |
| 凫绿 | Teal | #008080 |
| 暗青 | Dark Cyan | #008B8B |
| 青色 | Cyan | #00FFFF |
| 水色 | Aqua | #AFDFE4 |
| 暗绿松石色 | Dark Turquoise | #00CED1 |
| 军服蓝 | Cadet Blue | #5F9EA0 |
| 孔雀蓝 | Peacock Blue | #00808C |
| 婴儿粉蓝 | Powder Blue | #B0E0E6 |
| 浓蓝 | Strong Blue | #006374 |
| 亮蓝 | Light Blue | #ADD8E6 |
| 灰蓝 | Pale Blue | #7AB8CC |
| 萨克斯蓝 | Saxe Blue | #4798B3 |
| 深天蓝 | Deep Sky Blue | #00BFFF |
| 天蓝 | Sky Blue | #87CEEB |
| 亮天蓝 | Light Sky Blue | #87CEFA |
| 水手蓝 | Marine Blue | #00477D |
| 普鲁士蓝 | Prussian blue | #003153 |
| 钢青色 | Steel Blue | #4682B4 |
| 爱丽丝蓝 | AliceBlue | #F0F8FF |
| 岩灰 | Slate Gray | #708090 |
| 亮岩灰 | Light Slate Gray | #778899 |
| 道奇蓝 | Dodger Blue | #1E90FF |
| 矿蓝 | Mineral Blue | #004D99 |
| 湛蓝 | Azure | #007FFF |
| 韦奇伍德蓝 | Wedgwood Blue | #5686BF |
| 亮钢蓝 | Light Steel Blue | #B0C4DE |
| 钴蓝 | Cobalt Blue | #0047AB |
| 灰丁宁蓝 | Pale Denim | #5E86C1 |
| 矢车菊蓝 | Cornflower Blue | #6495ED |
| 鼠尾草蓝 | Salvia Blue | #4D80E6 |
| 暗婴儿粉蓝 | Dark Powder Blue | #003399 |
| 蓝宝石色 | Sapphire | #082567 |
| 国际奇连蓝 | International Klein Blue | #002FA7 |
| 蔚蓝 | Cerulean blue | #2A52BE |
| 品蓝 | Royal Blue | #4169E1 |
| 暗矿蓝 | Dark Mineral Blue | #24367D |
| 极浓海蓝 | Ultramarine | #0033FF |
| 天青石蓝 | Lapis Lazuli | #0D33FF |
| 幽灵白 | Ghost White | #F8F8FF |
| 薰衣草紫 | Lavender | #E6E6FA |
| 长春花色 | Periwinkle | #CCCCFF |
| 午夜蓝 | Midnight Blue | #191970 |
| 藏青 | NavyBlue | #000080 |
| 暗蓝 | Dark Blue | #00008B |
| 中蓝 | Medium Blue | #0000CD |
| 蓝色 | Blue | #0000FF |
| 紫藤色 | Wisteria | #5C50E6 |
| 暗岩蓝 | Dark Slate Blue | #483D8B |
| 岩蓝 | Slate Blue | #6A5ACD |
| 中岩蓝 | Medium SlateBlue | #7B68EE |
| 木槿紫 | Mauve | #6640FF |
| 紫丁香色 | Lilac | #B399FF |
| 中紫红 | Medium Purple | #9370DB |
| 紫水晶色 | Amethyst | #6633CC |
| 浅灰紫红 | Grayish Purple | #8674A1 |
| 缬草紫 | Heliotrope | #5000B8 |
| 矿紫 | Mineral Violet | #B8A1CF |
| 蓝紫 | Blue Violet | #8A2BE2 |
| 紫罗兰色 | Violet | #8B00FF |
| 靛色 | Indigo | #4B0080 |
| 暗兰紫 | Dark Orchid | #9932CC |
| 暗紫 | Dark Violet | #9400D3 |
| 三色堇紫 | Pansy | #7400A1 |
| 锦葵紫 | Mallow | #D94DFF |
| 优品紫红 | Opera Mauve | #E680FF |
| 中兰紫 | Medium Orchid | #BA55D3 |
| 淡紫丁香色 | Pail Lilac | #E6CFE6 |
| 蓟紫 | Thistle | #D8BFD8 |
| 铁线莲紫 | Clematis | #CCA3CC |
| 李紫 | Plum | #DDA0DD |
| 亮紫 | Light Violet | #EE82EE |
| 紫色 | Purple | #800080 |
| 暗洋红 | Dark Magenta | #8B008B |
| 洋红 | Magenta | #FF00FF |
| 品红 | Fuchsia | #F400A1 |
| 兰紫 | Orchid | #DA70D6 |
| 浅珍珠红 | Pearl Pink | #FFB3E6 |
| 陈玫红 | Old Rose | #B85798 |
| 浅玫瑰红 | Rose Pink | #FF66CC |
| 中青紫红 | Medium Violet Red | #C71585 |
| 洋玫瑰红 | Magenta Rose | #FF0DA6 |
| 玫瑰红 | Rose | #FF007F |
| 红宝石色 | Ruby | #CC0080 |
| 山茶红 | Camellia | #E63995 |
| 深粉红 | Deep Pink | #FF1493 |
| 火鹤红 | Flamingo | #E68AB8 |
| 浅珊瑚红 | Coral Pink | #FF80BF |
| 暖粉红 | Hot Pink | #FF69B4 |
| 勃艮第酒红 | Burgundy | #470024 |
| 尖晶石红 | Spinel Red | #FF73B3 |
| 胭脂红 | Carmine | #E6005C |
| 浅粉红 | Baby Pink | #FFD9E6 |
| 枢机红 | Cardinal Red | #990036 |
| 蕙衣草紫红 | Lavender Blush | #FFF0F5 |
| 灰紫红 | PaleViolet Red | #DB7093 |
| 樱桃红 | Cerise | #DE3163 |
| 浅鲑红 | Salmon Pink | #FF8099 |
| 绯红 | Crimson | #DC143C |
| 粉红 | Pink | #FFC0CB |
| 亮粉红 | Light Pink | #FFB6C1 |
| 亮黄红 | Shell Pink | #FFB3BF |
| 茜红 | Alizarin Crimson | #E32636 |
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| image | string | 必须 | 参考图 oss path | ||
| main_color_text | string | 非必须 | 颜色文本 指定的颜色文本词，可选文本参考款式配色。 可额外使用“随机纯色”、“随机撞色”和“按图配色” 。“随机纯色”将随机生成不同颜色；“随机撞色”将随机生成不同撞色配色；“按图配色”参考带色线稿的颜色。 | ||
| main_color_hex_code | string | 非必须 | 十六进制颜色码 指定的颜色编码，如 "#FFFFFF"。设置了main_color_text时，此参数不生效。 | ||
| use_ori_color | boolean | 非必须 | false | 是否参考原图颜色 | |
| rootCategory | string | 必须 | 一级分类：WOMAN(女装) 、MAN（男装）、CHILDREN（童装）、LUGGAGE（箱包）、SHOES（鞋靴）、HOME（内衣）传值例如：WOMAN | ||
| text | string | 非必须 | 风格文本："学院","甜美","田园","侘寂","暗黑","解构","街头","艺术","韩系","日系","法式"。（女装为例，详见“参数说明”） | ||
| diversity | number | 非必须 | 0.5 | 多样性 [0, 1]区间浮点数，默认0.5 创新程度： 0.3 , 0.6, 0.9 | |
| batch_size | integer | 非必须 | 生成图片数量 [1, 8]区间整数，默认8 | ||
| resolution | integer | 非必须 | 1024 | 生成图片尺寸 512, 768, 1024，默认1024 | |
| id | integer | 非必须 | 创建ID | ||
| name | string | 非必须 | 名称 | ||
| category | string | 必须 | 上传款式图的品类词："衬衫","T恤","针织衫","卫衣","背心","打底衫","罩衫","毛衣","吊带"。（女装为例，详见“参数说明”） | ||
| material | string | 非必须 | 上传款式图的材质词："棉","麻","真丝","毛/绒","皮","人造纤维","混纺","皮草","细纱线","牛仔布"（女装为例，详见“参数说明”） | ||
| menuCode | string | 非必须 | 菜单code | ||
| businessKey | integer | 非必须 | 业务字段，业务方可以自定义 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 非必须 | |||
| message | string | 非必须 | |||
| data | integer | 非必须 | 该值为任务ID。在“异步任务API调用”中，通过传入该值，得到生成结果 | ||
| requestId | string | 非必须 |
快捷线稿（仅鞋靴）
基本信息
Path： /sas/algorithm/shoe_sketch_extract
Method： POST
接口描述：
功能描述
根据用户上传的鞋靴图片，快速生成线稿图。
使用说明
调用者只需要提供鞋靴款式图，经过AI图像识别自动生成黑白线稿图。
图片要求
图片格式：'.JPG', '.PNG', '.JPEG', '.BMP', '.WEBP'
图片大小：不超过5MB
接口说明
api_name: sas_algorithm_shoe_sketch_extract
appKey: super-asigner-server
接口为异步接口，需要异步获取。异步接口api_name: sas_my_creation_query_one_id。点击跳转至异步API任务调用
功能示例
1.上传鞋靴图 2.生成结果
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| image | string | 必须 | 参考图 oss path | ||
| batch_size | integer | 非必须 | 8 | 生成图片数量 [1, 8]区间整数 | |
| id | integer | 非必须 | 创建ID | ||
| name | string | 非必须 | 名称 | ||
| menuCode | string | 非必须 | 菜单code | ||
| businessKey | integer | 非必须 | 业务字段，业务方可以自定义 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 非必须 | |||
| message | string | 非必须 | |||
| data | integer | 非必须 | 该值为任务ID。在“异步任务API调用”中，通过传入该值，得到生成结果 | ||
| requestId | string | 非必须 |
鞋面创作（仅鞋靴）
基本信息
Path： /sas/algorithm/vamp_creation
Method： POST
接口描述：
功能描述
根据用户上传的各种鞋子设计图，可以在保持鞋底不变的同时，生成多种近似的鞋面创新设计图，为设计师提供设计灵感创意。
使用说明
调用者需要提供鞋子的款式图。之后可以选择已上传款式图的“category（品类）”和“material（材质）”，以及想要创新的“风格”，在结合基本款式的同时自动生成各种鞋子鞋面的创新款式。
图片要求
图片格式：'.JPG', '.PNG', '.JPEG', '.BMP', '.WEBP'
图片大小：不超过5MB
接口说明
api_name: sas_algorithm_vamp_creation
appKey: super-asigner-server
接口为异步，结果需要异步获取，点击跳转至异步API任务调用
功能示例
1.上传款式图 2.款式信息
3.生成结果
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| image | string | 必须 | 参考图 oss path | ||
| rootCategory | string | 必须 | 一级分类：WOMAN(女装) 、MAN（男装）、CHILDREN（童装）、LUGGAGE（箱包）、SHOES（鞋靴）、HOME（内衣）传值例如：SHOES | ||
| text | string | 非必须 | 空字符串 | "空间解构","城市登山","鞋面毛边","轮胎鞋","气泡鞋","千禧鞋","溶解鞋","未来科技","鞋面装饰","大头鞋","缠绕系带","笑脸鞋","空军鞋","贝壳头","德训鞋","波浪鞋"。 | |
| diversity | number | 非必须 | 0.5 | 多样性 [0, 1]区间浮点数 | 枚举备注: 调整生成图像的多样性。值越高，生成结果的多样性越高，但同时准确性和质量有可能越低 |
| batch_size | integer | 非必须 | 生成图片数量 [1, 8]区间整数，默认8 | ||
| resolution | integer | 非必须 | 1024 | 生成图片尺寸 512, 768, 1024，默认1024 | |
| id | integer | 非必须 | 创建ID | ||
| name | string | 非必须 | 名称 | ||
| category | string | 非必须 | 类目词：详见“参数说明” | ||
| material | string | 非必须 | 材质词："皮革/人造革","真皮/牛皮/羊皮","橡胶/塑料","稀有皮","帆布","织物","尼龙","牛仔","丹宁","聚氨酯","TPR","TPU","EVA","PVC","PU","GG Supreme","粗花呢","丝绒","复合缎面","漆皮","翻毛皮"。 | ||
| menuCode | string | 非必须 | 菜单code | ||
| businessKey | integer | 非必须 | 业务字段，业务方可以自定义 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 非必须 | |||
| message | string | 非必须 | |||
| data | integer | 非必须 | 该值为任务ID。在“异步任务API调用”中，通过传入该值，得到生成结果 | ||
| requestId | string | 非必须 |
局部
指令改款
基本信息
Path： /sas/algorithm/image_redraw_prompt_flux
Method： POST
接口描述：
图片要求
图片格式：'.JPG', '.PNG', '.JPEG', '.BMP', '.WEBP'
图片大小：不超过5MB
接口说明
apiName: sas_algorithm_image_redraw_prompt_flux
appKey: super-asigner-server
接口为异步，结果需要异步获取，点击跳转至异步API任务调用
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| image | string | 必须 | 参考图，oss URL | ||
| mask | string | 必须 | Mask参考图，oss path | ||
| category | string | 非必须 | 品类 | ||
| attr | string | 非必须 | 元素 | ||
| process | string | 非必须 | 版型 | ||
| batch_size | integer | 非必须 | 生成图片数量 [1, 8]区间整数，默认8 | ||
| resolution | integer | 非必须 | 1024 | 生成图片尺寸 512, 768, 1024，默认1024 | |
| id | integer | 非必须 | 创建ID | ||
| businessKey | integer | 非必须 | 业务字段，业务方可以自定义 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 必须 | 响应编码，若成功请求为2000 | ||
| message | string | 必须 | 响应消息，若成功请求为 success | ||
| data | integer | 必须 | 该值为任务ID。在“异步任务API调用”中，通过传入该值，得到生成结果 | ||
| requestId | string | 必须 | 请求id |
重绘改款
基本信息
Path： /sas/algorithm/image_local_rewrite
Method： POST
接口描述：
功能描述
根据用户上传的商品图和手绘素材图，可以对任意区域进行重新绘制生成，并可以将简单的手绘部件真实地融合入商品。
使用说明
调用者需要提供款式图，通过各类工具在原款式图上绘制control_image_1（重绘线稿参考图）或直接上传手绘素材后；框选重绘的区域（mask），之后将在重绘区域内，采用重绘线稿图/手绘素材对原款式图进行重绘替换。
图片要求
图片格式：'.JPG', '.PNG', '.JPEG', '.BMP', '.WEBP'
图片大小：不超过5MB
参数说明
control_image_1（重绘线稿参考图）：黑色线稿图，如服装部件（领结，花边，口袋等）。
mask（重绘区域图）：覆盖的区域全部进行AI重绘，最好完全覆盖线稿参考图，并且不覆盖无需重绘的区域。
接口说明
api_name: sas_algorithm_image_local_rewrite
appKey: super-asigner-server
接口为异步，需要异步获取结果，点击跳转至异步API任务调用
功能示例
1.上传款式图 2.通过工具添加手绘线稿(重绘参考图) 3.确定重绘区域
4.生成结果
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| image | string | 必须 | 款式图，oss URL | ||
| mask | string | 必须 | 重绘区域图，oss path | ||
| control_image_1 | string | 必须 | 重绘参考图，oss path | ||
| rootCategory | string | 必须 | 一级分类：WOMAN(女装) 、MAN（男装）、CHILDREN（童装）、LUGGAGE（箱包）、SHOES（鞋靴）、HOME（内衣） 传值例如：WOMAN 说明 | ||
| text | string | 非必须 | 重绘部位说明文本，如：腰封，下摆，围裹，群面，门襟，帽子等。详见参数说明 | 枚举备注: 部位说明文本，可以让生成结果更精准，选填。 | |
| diversity | number | 非必须 | 0.5 | 多样性 [0, 1]区间浮点数，默认0.5 创新程度： 0.3 , 0.6, 0.9 可以控制款式图的重绘变化程度 | |
| batch_size | integer | 非必须 | 生成图片数量 [1, 8]区间整数，默认8 | ||
| resolution | integer | 非必须 | 1024 | 生成图片尺寸 512, 768, 1024，默认1024 | |
| id | integer | 非必须 | 创建ID | ||
| name | string | 非必须 | 名称 | ||
| category | string | 非必须 | 款式图的品类词："衬衫","T恤","针织衫","卫衣","背心","打底衫","罩衫","毛衣","吊带"。（女装为例，详见“参数说明”） | ||
| material | string | 非必须 | 上传款式图的材质词："棉","麻","真丝","毛/绒","皮","人造纤维","混纺","皮草","细纱线"。（女装为例，详见“参数说明”） | ||
| menuCode | string | 非必须 | 菜单code | ||
| businessKey | integer | 非必须 | 业务字段，业务方可以自定义 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 非必须 | 响应编码，若成功请求为2000 | ||
| message | string | 非必须 | 响应消息，若成功请求为 success | ||
| data | integer | 非必须 | 该值为任务ID。在“异步任务API调用”中，通过传入该值，得到生成结果 | ||
| requestId | string | 非必须 | 请求id |
随机改款
基本信息
Path： /sas/algorithm/imageRedraw
Method： POST
接口描述：
功能描述
根据用户上传的鞋服图片，可以对任意选中的部位进行随机替换，为设计师提供灵感创意。
使用说明
调用者需要提供鞋服图片，选择想要局部替换的部位“part_type”（不选择的话则随机替换），或者选择指定的mask区域图，在结合基本款式的同时自动生成各种创新款式。
图片要求
图片格式：'.JPG', '.PNG', '.JPEG', '.BMP', '.WEBP'
图片大小：不超过5MB
接口说明
api_name: sas_algorithm_imageRedraw
appKey: super-asigner-server
接口为异步，结果需要异步获取，点击跳转至异步API任务调用
功能示例
1.输入款式图 2.确定替换区域 3.生成结果
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| image | string | 必须 | 参考图，oss URL | ||
| mask | string | 非必须 | Mask参考图，oss path | ||
| part_type | string | 非必须 | None | 随机部位 可选：'None', 'collar', 'sleeve'； | 枚举备注: 需要指定随机部件位置时，可传'collar'(领口)或'sleeve'（袖口），不需要时不传或传'None'。 |
| rootCategory | string | 必须 | 一级分类：WOMAN(女装) 、MAN（男装）、CHILDREN（童装）、LUGGAGE（箱包）、SHOES（鞋靴）、HOME（内衣）传值例如：WOMAN | ||
| text | string | 非必须 | 生成文本，该功能默认为空 | ||
| diversity | number | 非必须 | 0.5 | 多样性 [0, 1]区间浮点数 | 枚举备注: 调整生成图像的多样性。值越高，生成结果的多样性越高，但同时准确性和质量有可能越低 |
| batch_size | integer | 非必须 | 生成图片数量 [1, 8]区间整数，默认8 | ||
| resolution | integer | 非必须 | 1024 | 生成图片尺寸 512, 768, 1024，默认1024 | |
| id | integer | 非必须 | 创建ID | ||
| name | string | 非必须 | 名称 | ||
| menuCode | string | 非必须 | 菜单code | ||
| businessKey | integer | 非必须 | 业务字段，业务方可以自定义 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 必须 | 响应编码，若成功请求为2000 | ||
| message | string | 必须 | 响应消息，若成功请求为 success | ||
| data | integer | 必须 | 该值为任务ID。在“异步任务API调用”中，通过传入该值，得到生成结果 | ||
| requestId | string | 必须 | 请求id |
部件替换
基本信息
Path： /sas/algorithm/image_recombination
Method： POST
接口描述：
功能描述
根据用户上传的商品加实物部件图，可以替换商品图对应位置的部件。
使用说明
调用者需要提供商品图加上部件后的图（1.原图 2.清除替换区域及周边 3.将部件图贴到需要替换的部位），之后算法对图片进行拼接。
图片要求
图片格式：'.JPG', '.PNG', '.JPEG', '.BMP', '.WEBP'
图片大小：不超过5MB
参数说明
image（款式图）：原图经过处理，加上部件的图。算法将自动对图像进行拼接处理，空白的地方会自动生成。如下：
mask（替换区域图）：覆盖的区域全部进行AI替换，最好完全覆盖部件图，并且不覆盖无需重绘的区域。
接口说明
api_name: sas_algorithm_image_recombination
appKey: super-asigner-server
接口为异步，需要异步获取结果，点击跳转至异步API任务调用
功能示例
1.上传款式图（原图） 2.清除需要替换的区域(算法会对空白地方进行拼接处理)
3.添加实体部件(算法输入的"image") 4.确定拼接(进行AI生成)区域("mask")
5.调用算法，生成结果
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| image | string | 必须 | 款式图，oss URL | 枚举备注: 原图经过处理，加上部件的图 | |
| mask | string | 必须 | Mask参考图，255表示遮罩区域, 0表示保持区域 | ||
| part_type | string | 必须 | 可选：'None', 'collar', 'sleeve'； | 枚举备注: 需要指定随机部件时，传'collar'(领口)或'sleeve'（袖口），不需要时不传或传'None'。 | |
| whole_mask | boolean | 非必须 | false | 是否后续接款式创新：True, False | |
| rootCategory | string | 必须 | 一级分类：WOMAN(女装) 、MAN（男装）、CHILDREN（童装）、LUGGAGE（箱包）、SHOES（鞋靴）、HOME（内衣）传值例如：WOMAN | ||
| text | string | 非必须 | 生成文本，该功能默认为空 | ||
| diversity | number | 非必须 | 0.5 | 多样性 [0, 1]区间浮点数，默认0.5 | |
| batch_size | integer | 非必须 | 8 | 生成图片数量 [1, 8]区间整数 | |
| resolution | integer | 非必须 | 1024 | 生成图片尺寸 512, 768, 1024 | |
| id | integer | 非必须 | 创建ID | ||
| name | string | 非必须 | 名称 | ||
| menuCode | string | 非必须 | 菜单code | ||
| businessKey | integer | 非必须 | 业务字段，业务方可以自定义 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 非必须 | |||
| message | string | 非必须 | |||
| data | integer | 非必须 | 通过该值查询生成结果，详细查看“必要接口-异步API任务调用” | ||
| requestId | string | 非必须 |
图案
图案创新
基本信息
Path： /sas/algorithm/logo_plain_logo
Method： POST
接口描述：
功能描述
调用者只需上传任意图案，即可生成近似创新图案。
图片要求
图片格式：'.JPG', '.PNG', '.JPEG', '.BMP', '.WEBP'
图片大小：不超过5MB
接口说明
apiName: sas_algorithm_logo_plain_logo
appKey: super-asigner-server
接口为异步，需要异步获取结果，点击跳转至异步API任务调用
功能示例
1.上传图案参考图 2.生成结果
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| image | string | 必须 | 参考图, 公网可访问的url | ||
| filter_text | string | 非必须 | 文本内容，供过滤 | ||
| diversity | number | 非必须 | 0.85 | 值越大结果图越偏离输入图，取值为[0.7,0.75,0.8,0.85,0.9],默认为0.85 | |
| batch_size | integer | 非必须 | 生成图片数量 [1, 8]区间整数，默认1 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 非必须 | |||
| message | string | 非必须 | |||
| data | integer | 非必须 | 该值为任务ID。在“异步任务API调用”中，通过传入该值，得到生成结果 | ||
| requestId | string | 非必须 |
面料
面料创作
基本信息
Path： /sas/algorithm/patternToPattern
Method： POST
接口描述：
功能描述
根据用户上传的面料图，可以生成不同风格的近似面料，为设计师提供面料设计灵感。
使用说明
调用者只需要提供面料图，即可生成近似面料。
图片要求
图片格式：'.JPG', '.PNG', '.JPEG', '.BMP', '.WEBP'
图片大小：不超过5MB
说明
api_name: sas_algorithm_patternToPattern
接口为异步接口，结果需要异步获取，点击跳转至异步API任务调用
功能示例
1.上传面料图
2.生成结果
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| image | string | 必须 | 参考图 oss path | ||
| rootCategory | string | 必须 | 一级分类 | ||
| text | string | 非必须 | "" | 风格文本，默认为空字符串 | |
| diversity | number | 非必须 | 0.5 | 多样性 [0, 1]区间浮点数 | 枚举备注: 调整生成图像的多样性。值越高，生成结果的多样性越高，但同时准确性和质量有可能越低 |
| batch_size | integer | 非必须 | 8 | 生成图片数量 [1, 8]区间整数 | |
| resolution | integer | 非必须 | 1024 | 生成图片尺寸 512, 768, 1024 | |
| id | integer | 非必须 | 创建ID | ||
| name | string | 非必须 | 名称 | ||
| menuCode | string | 非必须 | 菜单code | ||
| businessKey | integer | 非必须 | 业务字段，业务方可以自定义 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 非必须 | |||
| message | string | 非必须 | |||
| data | integer | 非必须 | 该值为任务ID。在“异步任务API调用”中，通过传入该值，得到生成结果 | ||
| requestId | string | 非必须 |
面料替换-整体+局部替换_新版
基本信息
Path： /sas/algorithm/image_material_replace_new
Method： POST
接口描述：
图片要求
图片格式：'.JPG', '.PNG', '.JPEG', '.BMP', '.WEBP'
图片大小：不超过5MB
接口说明
api_name： sas_algorithm_image_material_replace_new
异步接口，结果需要异步获取，点击跳转至异步API任务调用
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| image | string | 必须 | 参考图 oss path | ||
| material_image | string | 必须 | 材质图 oss path | ||
| mask | string | 非必须 | Mask图 oss path 前景白色，背景黑色，0 ~ 255 灰度图。如不传参，则使用内部默认分割算法。 | ||
| fg_prompt | string | 非必须 | 分割前景物体英文词 使用内部默认分割算法时，可指定分割前景物体英文词，可选项包括"upper" "lower" "overall"，以及常见英文类目词。不传默认为"overall"。 | ||
| obj_type | string | 非必须 | 款式类型 可选项: "plain"，表示素胚 ; "non_plain"，表示非素胚。默认"plain"素胚。 | 枚举备注: 款式类型，二选一。根据实际情况选择，会影响生成效果。 | |
| obj_height | number | 非必须 | 款式长 衣长或者主体高度，默认1.0 | ||
| material_height | number | 非必须 | 面料长 面料长度，默认0.2 | ||
| material_pos_x | string | 非必须 | 面料中心位置x：面料图中心点横坐标相对替换区域的横向位置，默认0.5表示面料中心点在替换区域横向一半的位置。坐标原点在左上角。 | ||
| material_pos_y | string | 非必须 | 面料中心位置y：面料图中心点纵坐标相对替换区域的纵向位置，默认0.5表示面料中心点在替换区域纵向一半的位置。坐标原点在左上角。 | ||
| material_rotate_angle | string | 非必须 | 面料旋转角度 面料图旋转角度，逆时针方向，单位是度。如90代表逆时针方向旋转90度。 | ||
| refine_tile | boolean | 非必须 | 是否重绘优化面料拼接处，默认True。 | ||
| category | string | 非必须 | 类目词 类目词，默认为空 | ||
| material | string | 非必须 | 材质词 材质词，默认为空 | ||
| mode | string | 非必须 | 模型类型。旧模型：classic 新模型：renewal 默认： classic | ||
| batch_size | integer | 非必须 | 8 | 生成图片数量 [1, 8]区间整数 | |
| resolution | integer | 非必须 | 1024 | 生成图片尺寸 512, 768, 1024，默认1024 | |
| id | integer | 非必须 | 创建ID | ||
| name | string | 非必须 | 名称 | ||
| menuCode | string | 非必须 | 菜单code | ||
| businessKey | integer | 非必须 | 业务字段，业务方可以自定义 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 非必须 | |||
| message | string | 非必须 | |||
| data | integer | 非必须 | 该值为任务ID。在“异步任务API调用”中，通过传入该值，得到生成结果 | ||
| requestId | string | 非必须 |
面料替换-局部替换
基本信息
Path： /sas/algorithm/image_local_material
Method： POST
接口描述：
功能描述
根据用户上传的服装和面料图，可以替换任意部位的面料
使用说明
调用者提供款式图、面料图。之后选择需要替换的区域（mask），可对款式图中mask对应区域面料进行替换，为了提高生成效果，可填写勉款式/面料图真实尺寸，根据修改区域长和上传面料长的比例进行结果生成，未设置则比例默认1:1。
图片要求
图片格式：'.JPG', '.PNG', '.JPEG', '.BMP', '.WEBP'
图片大小：不超过5MB
参数说明
真实尺寸：不小于0的数，单位为cm
接口说明
api_name: sas_algorithm_image_local_material
接口为异步接口，需要异步获取，点击跳转至异步API任务调用
功能示例
1.输入款式图： 2.输入面料图 3.确定选区
4.生成结果
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| image | string | 必须 | 款式图 oss path | ||
| mask | string | 必须 | 选择区域图，oss path，255为遮罩区域 | ||
| material_image | string | 必须 | 面料图,oss path | ||
| obj_height | number | 非必须 | 款式长：(cm) | 枚举备注: 款式长：(cm) 款式图片的真实长度/高度尺寸，选填 | |
| material_height | number | 非必须 | 面料长：(cm) | 枚举备注: 面料图片高度对应的真实长度/高度，选填 | |
| rootCategory | string | 必须 | 一级分类：WOMAN(女装) 、MAN（男装）、CHILDREN（童装）、LUGGAGE（箱包）、HOME（内衣）传值例如：WOMAN。 | 枚举备注: 暂不支持：SHOES（鞋靴） | |
| id | integer | 非必须 | 创建ID | ||
| name | string | 非必须 | 名称 | ||
| menuCode | string | 非必须 | 菜单code | ||
| businessKey | integer | 非必须 | 业务字段，业务方可以自定义 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 非必须 | 响应编码，若成功请求为2000 | ||
| message | string | 非必须 | 响应消息，若成功请求为 success | ||
| data | number | 非必须 | 该值为任务ID。在“异步任务API调用”中，通过传入该值，得到生成结果 | ||
| requestId | string | 非必须 | 请求id |
颜色
局部换色
基本信息
Path： /sas/algorithm/shoe_local_color
Method： POST
接口描述：
功能描述
根据用户上传的服装图，可以将任意部位替换成任意颜色
使用说明
调用者提供款式图，并选择"mask(换色区域)"，和rgb色值，即可对款式图中mask对应区域颜色进行替换
图片要求
图片格式：'.JPG', '.PNG', '.JPEG', '.BMP', '.WEBP'
图片大小：不超过5MB
接口说明
api_name: sas_algorithm_shoe_local_color
接口为异步接口，需要异步获取，点击跳转至异步API任务调用
功能示例
1.上传款式图 2.选定色号 3.确定换色区域
4.生成结果
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| image | string | 必须 | 款式图 oss path | 枚举备注: 255为遮罩区域 | |
| mask | string | 必须 | 换色区域图oss path | ||
| rgb_color_value | string | 必须 | 必须 '#d9d8b4' | 十六进制色值 | |
| diversity | string | 非必须 | 0.5 | 生图多样性 [0, 1]区间浮点数 | 枚举备注: 调整生成图像的多样性。值越高，生成结果的多样性越高，但同时准确性和质量有可能越低 |
| text | string | 非必须 | 默认为空字符串，对该功能暂无作用 | ||
| batch_size | integer | 非必须 | 生图数量 [1, 8]区间整数，默认8 | ||
| color_preprocess_method | string | 非必须 | color_transfer | 可选"color_transfer","wavelet" | 枚举备注: 预处理上色方式，默认即可 |
| do_refine_mask | boolean | 非必须 | false | 是否SAM自动修mask，默认False | |
| resolution | integer | 非必须 | 1024 | 生图分辨率 512, 768, 1024 | |
| rootCategory | string | 必须 | 一级分类：WOMAN(女装) 、MAN（男装）、CHILDREN（童装）、LUGGAGE（箱包）、SHOES（鞋靴）、HOME（内衣）传值例如：WOMAN | ||
| id | integer | 非必须 | 创建ID | ||
| name | string | 非必须 | 名称 | ||
| menuCode | string | 非必须 | 菜单code | ||
| businessKey | integer | 非必须 | 业务字段，业务方可以自定义 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 必须 | 响应编码，若成功请求为2000 | ||
| message | string | 必须 | 响应消息，若成功请求为 success | ||
| data | number | 必须 | 该值为任务ID。在“异步任务API调用”中，通过传入该值，得到生成结果 | ||
| requestId | string | 必须 | 请求id |
颜色替换
基本信息
Path： /sas/algorithm/image_color_new
Method： POST
接口描述：
功能描述
根据用户上传的服装和选择的颜色，可以快速替换服装的颜色，实现同款服装多种颜色的快速生成。
使用说明
调用者需要提供基础款式图，并根据换色模式，确定需要更换的颜色，即可自动生成基础款式更换颜色后的创新款式。
图片要求
图片格式：'.JPG', '.PNG', '.JPEG', '.BMP', '.WEBP'
图片大小：不超过5MB
接口说明
api_name: sas_algorithm_image_color_new
异步接口，需要异步获取点击跳转至异步API任务调用
功能示例
1.上传款式图 2.选择颜色 3.生成结果
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| image | string | 必须 | 参考图 oss path | ||
| mode | string | 必须 | 1."random"：随机换色，同老版本颜色替换接口 2."main_color_text"：文本指定主颜色 3."main_color_hex_code"：十六进制颜色码指定主颜色 | 枚举备注: 换色模式，三选一 | |
| main_color_text | string | 非必须 | 颜色文本词。 如"黑色" 或"black" | 枚举备注: 支持自定义，只需传入一个中文或英文颜色词即可。（部分颜色效果不稳定） | |
| main_color_hex_code | string | 非必须 | 十六进制颜色码 指定的十六进制颜色码，如 "#FFFFFF"， | 枚举备注: 如选择“指定颜色模式”，则该参数为必须 | |
| rootCategory | string | 必须 | 一级分类：WOMAN(女装) 、MAN（男装）、CHILDREN（童装）、LUGGAGE（箱包）、SHOES（鞋靴）、HOME（内衣）传值例如：WOMAN | ||
| text | string | 非必须 | 生成文本词，该功能默认为空 | 枚举备注: | |
| diversity | number | 非必须 | 0.5 | 多样性 [0, 1]区间浮点数，默认0.5 创新程度： 0.3 , 0.6, 0.9 | 枚举备注: 调整生成图像的多样性。值越高，生成结果的多样性越高，但同时准确性和质量有可能越低 |
| batch_size | integer | 非必须 | 生成图片数量 [1, 8]区间整数，默认8 | ||
| resolution | integer | 非必须 | 1024 | 生成图片尺寸 512, 768, 1024，默认1024 | |
| id | integer | 非必须 | 创建ID | ||
| name | string | 非必须 | 名称 | ||
| menuCode | string | 非必须 | 菜单code | ||
| businessKey | integer | 非必须 | 业务字段，业务方可以自定义 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 非必须 | |||
| message | string | 非必须 | |||
| data | integer | 非必须 | 该值为任务ID。在“异步任务API调用”中，通过传入该值，得到生成结果 | ||
| requestId | string | 非必须 |
随机换色
基本信息
Path： /sas/algorithm/imageColor
Method： POST
接口描述：
功能描述
根据用户上传的服装，可以快速随机替换服装的颜色，为设计师提供多种颜色的设计灵感。
使用说明
调用者需要提供基础款式图，即可自动生成基础款式的多种不同颜色的创新款式。
图片要求
图片格式：'.JPG', '.PNG', '.JPEG', '.BMP', '.WEBP'
图片大小：不超过5MB
接口说明
apiName: sas_algorithm_imageColor
异步接口，需要异步获取，点击跳转至异步API任务调用
功能示例
1.上传款式图 2.确定款式信息
3.生成结果
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| image | string | 必须 | 参考图, oss path | ||
| rootCategory | string | 必须 | 一级分类：WOMAN(女装) 、MAN（男装）、CHILDREN（童装）、LUGGAGE（箱包）、SHOES（鞋靴）、HOME（内衣）传值例如：WOMAN | ||
| text | string | 非必须 | 风格文本词，如："学院","甜美","田园","侘寂","暗黑"等，详见参数说明 | 枚举备注: 在该功能中，只对换色颜色有影响，不改变服装/鞋靴整体款式 | |
| diversity | number | 非必须 | 0.5 | 多样性 [0, 1]区间浮点数 | |
| batch_size | integer | 非必须 | 8 | 生成图片数量 [1, 8]区间整数，默认8 | |
| resolution | integer | 非必须 | 1024 | 生成图片尺寸 512, 768, 1024，默认1024 | |
| name | string | 非必须 | 名称，默认使用UUID;不可重复 | ||
| category | string | 非必须 | 款式图的品类词，如："衬衫","T恤","针织衫","卫衣","背心"等，详见参数说明 | 枚举备注: 未选择时，将由AI进行随机创作 在该功能中，只对换色颜色有影响，不改变服装/鞋靴品类 | |
| material | string | 非必须 | 款式图的材质词，如："棉","麻","真丝","毛/绒"，详见参数说明 | 枚举备注: 未选择时，将由AI进行随机创作 在该功能中，只对换色颜色有影响，不改变服装/鞋靴材质 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 非必须 | |||
| message | string | 非必须 | |||
| data | integer | 非必须 | 该值为任务ID。在“异步任务API调用”中，通过传入该值，得到生成结果 | ||
| requestId | string | 非必须 |
灵感配色（仅鞋靴）
基本信息
Path： /sas/algorithm/inspiration_to_color
Method： POST
接口描述：
功能描述
根据用户上传的鞋靴图和灵感参考图，生成参考灵感图的鞋靴图。
使用说明
调用者需要提供款式图（image）和灵感图（inspiration_image），即可在结合基本款式的同时自动生成各种创新款式和配色方案。
图片要求
图片格式：'.JPG', '.PNG', '.JPEG', '.BMP', '.WEBP'
图片大小：不超过5MB
接口说明
api_name: sas_algorithm_inspiration_to_color
接口为异步接口，结果需要异步获取，点击跳转至异步API任务调用
功能示例
1.上传款式图 2.上传灵感图
3.生成结果
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| image | string | 必须 | 参考图 oss path | ||
| inspiration_image | string | 必须 | 灵感图 oss path | ||
| rootCategory | string | 必须 | 一级分类：鞋靴 | 枚举备注: 该功能目前仅支持鞋靴 | |
| text | string | 非必须 | 风格文本，该功能默认为空 | ||
| diversity | number | 非必须 | 0.5 | 多样性 [0, 1]区间浮点数，默认0.5 | 枚举备注: 调整生成图像的多样性。值越高，生成结果的多样性越高，但同时准确性和质量有可能越低 |
| batch_size | integer | 非必须 | 生成图片数量 [1, 8]区间整数，默8 | ||
| resolution | integer | 非必须 | 1024 | 生成图片尺寸 512, 768, 1024，默认1024 | |
| id | integer | 非必须 | 创建ID | ||
| name | string | 非必须 | 名称 | ||
| menuCode | string | 非必须 | 菜单code | ||
| businessKey | integer | 非必须 | 业务字段，业务方可以自定义 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 非必须 | |||
| message | string | 非必须 | |||
| data | integer | 非必须 | 该值为任务ID。在“异步任务API调用”中，通过传入该值，得到生成结果 | ||
| requestId | string | 非必须 |
其他工具
huggingface重打光
基本信息
Path： /sas/algorithm/image_relighting_open_source
Method： POST
接口描述：
图片要求
图片格式：'.JPG', '.PNG', '.JPEG', '.BMP', '.WEBP'
图片大小：不超过10MB
接口说明
api_name：sas_algorithm_image_relighting_open_source
appKey: super-asigner-server
qps:10
异步接口，结果需要异步获取。异步接口api_name: sas_my_creation_query_one_id。
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| image | string | 必须 | 原图，url格式 | ||
| inference_mode | string | 必须 | free_txt2bg_gen | 默认free_txt2bg_gen 取值范围free_txt2bg_gen, replica_gen。free_txt2bg_gen为自由文本生图，replica_gen为单图复刻 | |
| mode | string | 非必须 | normal | 默认normal,取值范围normal, uniform-lit | |
| prompt | string | 非必须 | 文本描述。inference_mode为free_txt2bg_gen时必填 | ||
| ref_img | string | 非必须 | 参考图，url格式。inference_mode为replica_gen时必填 | ||
| seed | integer | 非必须 | -1 | 随机种子，-1为随机 默认为-1 | |
| steps | integer | 非必须 | 步数，默认为20 | ||
| return_fmt | string | 非必须 | jpeg | 返回图像编码格式, 默认 jpeg. 取值范围jpeg, png | |
| batch_size | integer | 非必须 | 生成图片数量 [1, 8]区间整数，默认1 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| requestId | string | 非必须 | 请求编号 | ||
| code | integer | 非必须 | |||
| message | string | 非必须 | |||
| data | integer | 非必须 |
原子能力-商品检测
基本信息
Path： /sas/algorithm/detection
Method： POST
接口描述：
接口说明
appKey: super-asigner-server
apiName: sas_algorithm_detection
qps:1
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| image | string | 必须 | 参考图 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 必须 | 成功返回 2000 | ||
| message | string | 必须 | 成功返回 success | ||
| data | string | 必须 | 多主体检测结果 json字符串，如：'[{"rect": {"x1": 88, "x2": 1133, "y1": 185, "y2": 1098}, "confidence": 0.9657, "cate": "鞋子", "roi": [88, 185, 1133, 1098]}]' 其中rect表示包围框坐标，以图像左上角为原点。confidence表示置信度。cate表示品类。roi表示rect的简化表示。 | ||
| requestId | string | 必须 |
原子能力-商品白底图检测
基本信息
Path： /sas/algorithm/singleton
Method： POST
接口描述：
接口说明
appKey: super-asigner-server
apiName: sas_algorithm_singleton
qps:10
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| image | string | 必须 | 参考图 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 必须 | 成功返回 2000 | ||
| message | string | 必须 | 成功返回 success | ||
| data | string | 必须 | 白底图评估结果 json字符串，如：{"mothed": "singleton", "score": 1.1740902472467951e-08} 其中score表示白底图评分，一般大于等于0.9995可判定为白底图。 | ||
| requestId | string | 必须 |
图案上身
基本信息
Path： /sas/algorithm/image_print_replace
Method： POST
接口描述：
appKey: super-asigner-server
api_name: sas_algorithm_image_print_replace
qps: 10
接口为异步接口，需要异步获取，点击跳转至异步API任务调用
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| image | string | 必须 | 参考图 oss path | ||
| print_image | string | 必须 | 图案图 oss path | ||
| mask | string | 非必须 | Mask图 前景白色，背景黑色，0 ~ 255 灰度图。如不传参，则使用内部默认分割算法。 | ||
| fg_prompt | string | 非必须 | 分割前景物体英文词 使用内部默认分割算法时，可指定分割前景物体英文词，可选项包括"upper" "lower" "overall"，以及常见英文类目词。不传默认为"garment"。 | ||
| obj_type | string | 非必须 | 款式类型 可选项: "plain"表示素胚 ; "non_plain"表示非素胚。默认"plain"素胚。 | ||
| obj_height | string | 非必须 | 款式长 衣长或者主体高度，默认1.0 | ||
| print_height | string | 非必须 | 图案图高度 图案图高度，默认0.2 | ||
| print_pos_x | string | 非必须 | 图案中心位置x 图案图中心点横坐标相对替换区域的横向位置，默认0.5表示图案中心点在替换区域横向一半的位置。坐标原点在左上角。 | ||
| print_pos_y | string | 非必须 | 图案中心位置y 图案图中心点纵坐标相对替换区域的纵向位置，默认0.5表示图案中心点在替换区域纵向一半的位置。坐标原点在左上角。 | ||
| print_rotate_angle | string | 非必须 | 图案旋转角度 图案图旋转角度，逆时针方向，单位是度。如90代表逆时针方向旋转90度。 | ||
| resolution | integer | 非必须 | 生成图片尺寸 512, 768, 1024，默认1024 | ||
| batch_size | integer | 非必须 | 生成图片数量 [1, 8]区间整数 | ||
| businessKey | integer | 非必须 | 业务字段，业务方可以自定义 | ||
| id | integer | 非必须 | 创建ID | ||
| name | string | 非必须 | 名称，默认使用UUID;不可重复 | ||
| menuCode | string | 非必须 | 菜单code | ||
| callBackUrl | string | 非必须 | 异步任务回调url,具体格式请参考异步回调接口 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| requestId | string | 非必须 | 请求编号 | ||
| code | integer | 非必须 | 响应码 | ||
| message | string | 非必须 | 响应消息 | ||
| data | integer | 非必须 | 该值为任务ID。在“异步任务API调用”中，通过传入该值，得到生成结果 |
手脚修复
基本信息
Path： /sas/algorithm/flux_inpainting_app
Method： POST
接口描述：
图片要求
图片格式：'.JPG', '.PNG', '.JPEG', '.BMP', '.WEBP'
图片大小：不超过10MB
接口说明
api_name： sas_algorithm_flux_inpainting_app
appKey: super-asigner-server
qps:10
异步接口，结果需要异步获取。异步接口api_name: sas_my_creation_query_one_id。
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| image | string | 必须 | 参考图url | ||
| mask | string | 非必须 | mask url，需与image分辨率一致 0~255灰度图。修手脚时非必需，其余必需 | ||
| prompt | string | 非必须 | 提示词 默认为"" | ||
| inference_steps | integer | 非必须 | 推理步数 默认为20 | ||
| strength | number | 非必须 | 重绘强度 默认为0.7 | ||
| guidance_scale | number | 非必须 | guidance scale 默认为3.5 | ||
| seed | integer | 非必须 | 随机种子，-1为随机 默认为-1 | ||
| diffdiff_scale | integer | 非必须 | diff-diff算法强度 默认为5 | ||
| max_size | number | 非必须 | 最大图像尺寸 默认为1024 | ||
| custom_mask | boolean | 非必须 | 是否上传custom mask True则diff-diff不生效，直接使用上传的mask，False则内部处理mask，默认为False | ||
| auto_hands_feet_fix | boolean | 非必须 | false | 自动手脚修复 默认False。该值为False时，mask 必填。 自动修手、自动修脚、自动修手脚都为True时，生效优先级：auto_hands_feet_fix > auto_hands_fix > auto_feet_fix | |
| auto_hands_fix | boolean | 非必须 | 自动修手 默认False。 | ||
| auto_feet_fix | boolean | 非必须 | false | 自动修脚 默认False。 | |
| ori_size_return | boolean | 非必须 | 是否返回原尺寸图片 默认False | ||
| batch_size | integer | 非必须 | 生成图片数量 [1, 8]区间整数，默认1 | ||
| id | integer | 非必须 | 创建ID | ||
| name | string | 非必须 | 名称，默认使用UUID;不可重复 | ||
| businessKey | string | 非必须 | 业务字段，业务方可以自定义 | ||
| callBackUrl | string | 非必须 | 异步任务回调url,具体格式请参考异步回调接口 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 非必须 | 响应码 | ||
| message | string | 非必须 | 响应消息 | ||
| data | integer | 非必须 | 该值为任务ID。在“异步任务API调用”中，通过传入该值，得到生成结果 | ||
| requestId | string | 非必须 | 请求编号 |
批量执行生成任务
基本信息
Path： /sas/algorithm/batch_execute_algorithm
Method： POST
接口描述：
接口说明
api_name: sas_algorithm_batch_execute_algorithm
批量执行生成任务，bizType 为：执行类型。
入参示例
例如款式创新：
{
"bizType": "image_to_image",
"algorithmParams": [{
"image": "sas/image/XXXX.jpg",
"rootCategory": "SHOES",
"batch_size": 1
},{
"image": "sas/image/XXXX.jpg",
"rootCategory": "SHOES",
"batch_size": 1
}]
}
bizType说明
| 功能说明 | code |
|---|---|
| 款式创新 | image_to_image |
| 创意融合 | image_merge_v2 |
| 灵感实验室 | inspiration_to_image |
| 鞋面创作 | vamp_creation |
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| bizType | string | 非必须 | 功能类型 | ||
| algorithmParams | object [] | 非必须 | 业务参数列表，格式参考备注 | item 类型: object | |
| ├─ key | object | 非必须 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 非必须 | |||
| message | string | 非必须 | |||
| data | string | 非必须 | 任务编号 | ||
| requestId | string | 非必须 | 请求编号 |
颜色分析
基本信息
Path： /sas/algorithm/color_analysis
Method： POST
接口描述：
图片要求
图片格式：'.JPG', '.PNG', '.JPEG', '.BMP', '.WEBP'
图片大小：不超过5MB
接口说明
api_name: sas_algorithm_color_analysis
appKey：super-asigner-server
qps: 1
接口为同步接口，无需异步获取
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| image | string | 必须 | 参考图 url | ||
| onlyForeground | boolean | 非必须 | 是否只分析前景物体 针对款式图，设置为True，将对款式进行精确分割后分析颜色。针对图案或者面料，设置为False，分析全图颜色。默认为False。 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 非必须 | |||
| message | string | 非必须 | |||
| data | object | 非必须 | |||
| ├─ color | string | 非必须 | 颜色列表及其对应的潘通色号 json字符串，如：[{"pct": 0.6305, "rgb": [254, 230, 230], "pantone": {"tpg": "12-2907TPG", "color_name": "Pink Marshmallow", "color_hex": "#F8E3E8", "color_rgb": "[248, 227, 232]"}}, {"pct": 0.1777, "rgb": [4, 3, 3], "pantone": {"tpg": "19-4004TPG", "color_name": "Tap Shoe", "color_hex": "#3C3C3E", "color_rgb": "[60, 60, 62]"}}, {"pct": 0.1542, "rgb": [250, 223, 34], "pantone": {"tpg": "13-0858TPG", "color_name": "Vibrant Yellow", "color_hex": "#FDDB27", "color_rgb": "[253, 219, 39]"}}, {"pct": 0.022, "rgb": [112, 101, 87], "pantone": {"tpg": "18-1015TPG", "color_name": "Shitake", "color_hex": "#746759", "color_rgb": "[116, 103, 89]"}}, {"pct": 0.0156, "rgb": [226, 176, 9], "pantone": {"tpg": "14-0958TPG", "color_name": "Bumblebee", "color_hex": "#F0B903", "color_rgb": "[240, 185, 3]"}}] 其中pct表示色彩占比权重，为0~1之间小数。rgb表示原始色彩值。pantone表示映射最接近的潘通色卡信息，包括tpg编码、color_name名称、显示值color_hex和color_rgb。 | ||
| requestId | string | 非必须 |
去背景&去图案-同步接口
基本信息
Path： /sas/algorithm/clothes_prepare_sync
Method： POST
接口描述：
功能描述
调用者提供图片，可通过修改判定值以分别实现清除服装背景和服装logo的功能。
图片要求
图片格式：'.JPG', '.PNG', '.JPEG', '.BMP', '.WEBP'
图片大小：不超过5MB
接口说明
api_name: sas_algorithm_clothes_prepare_sync
同步接口，结果无需异步获取
功能示例
1.去图案 2.去背景
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| clear_clothes_bg | boolean | 非必须 | 是否清除服装背景 | ||
| clear_clothes_logo | boolean | 非必须 | 是否清除服装上的logo | ||
| prompt_points | string [] | 非必须 | 是否清除服装上的logo | item 类型: string | |
| ├─ | 非必须 | ||||
| prompt_bdbox | string | 非必须 | 用户用鼠标框选的box, 为"0,0,100,299"这种形式 | ||
| prompt_text | string [] | 非必须 | 用户用文字指定的清除对象，比如只想清除文字则为'text'这样 | item 类型: string | |
| ├─ | 非必须 | ||||
| image | string | 必须 | 参考图，base64格式 | ||
| rootCategory | string | 必须 | 一级分类 | ||
| text | string | 非必须 | 风格文本 | ||
| diversity | number | 非必须 | 0.5 | 多样性 [0, 1]区间浮点数，默认0.5 创新程度： 0.3 , 0.6, 0.9 | |
| batch_size | integer | 非必须 | 生成图片数量 [1, 8]区间整数，默认8 | ||
| resolution | integer | 非必须 | 1024 | 生成图片尺寸 512, 768, 1024，默认1024 | |
| id | integer | 非必须 | 创建ID | ||
| name | string | 非必须 | 名称 | ||
| category | string | 非必须 | 类目词 | ||
| material | string | 非必须 | 材质词 | ||
| menuCode | string | 非必须 | 菜单code | ||
| businessKey | integer | 非必须 | 业务字段，业务方可以自定义 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 非必须 | |||
| message | string | 非必须 | |||
| data | string | 非必须 | |||
| requestId | string | 非必须 |
去背景&去图案-异步接口
基本信息
Path： /sas/algorithm/clothes_prepare
Method： POST
接口描述：
功能描述
调用者提供图片，可通过修改判定值以分别实现清除服装背景和服装logo的功能。
图片要求
图片格式：'.JPG', '.PNG', '.JPEG', '.BMP', '.WEBP'
图片大小：不超过5MB
接口说明
api_name: sas_algorithm_clothes_prepare
接口为异步接口，需要异步获取。异步接口api_name: sas_my_creation_query_one_id。
功能示例
1.去图案 2.去背景
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| clear_clothes_bg | boolean | 非必须 | 是否清除服装背景 | ||
| clear_clothes_logo | boolean | 非必须 | 是否清除服装上的logo | ||
| prompt_points | string [] | 非必须 | 是否清除服装上的logo | item 类型: string | |
| ├─ | 非必须 | ||||
| prompt_bdbox | string | 非必须 | 用户用鼠标框选的box, 为"0,0,100,299"这种形式 | ||
| prompt_text | string [] | 非必须 | 用户用文字指定的清除对象，比如只想清除文字则为'text'这样 | item 类型: string | |
| ├─ | 非必须 | ||||
| image | string | 必须 | 参考图，base64格式 | ||
| rootCategory | string | 必须 | 一级分类 | ||
| text | string | 非必须 | 风格文本 | ||
| diversity | number | 非必须 | 0.5 | 多样性 [0, 1]区间浮点数，默认0.5 创新程度： 0.3 , 0.6, 0.9 | |
| batch_size | integer | 非必须 | 生成图片数量 [1, 8]区间整数，默认8 | ||
| resolution | integer | 非必须 | 1024 | 生成图片尺寸 512, 768, 1024，默认1024 | |
| id | integer | 非必须 | 创建ID | ||
| name | string | 非必须 | 名称 | ||
| category | string | 非必须 | 类目词 | ||
| material | string | 非必须 | 材质词 | ||
| menuCode | string | 非必须 | 菜单code | ||
| businessKey | integer | 非必须 | 业务字段，业务方可以自定义 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 非必须 | 响应编码，若成功请求为2000 | ||
| message | string | 非必须 | 响应消息，若成功请求为 success | ||
| data | number | 非必须 | 该值为任务ID。在“异步任务API调用”中，通过传入该值，得到生成结果 | ||
| requestId | string | 非必须 | 请求id |
高清图生成,AI放大镜
基本信息
Path： /sas/algorithm/imageUpscale
Method： POST
接口描述：
功能描述
调用者提供图片，可提高图片分辨率，生成3072分辨率的高清图，图片较长边将为3072，另外一边将根据原图长宽比例生成。
图片要求
图片格式：'.JPG', '.PNG', '.JPEG', '.BMP', '.WEBP'
图片大小：不超过5MB
接口说明
api_name: sas_algorithm_imageUpscale
接口为异步接口，需要异步获取
功能示例
1.原图 2.结果图
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| image | string | 必须 | 参考图 oss path | ||
| output_format | string | 非必须 | "jpg" | 设定输出图像的格式，支持'jpg'和'png',默认为jpg | |
| dpi | integer | 非必须 | 300 | 设定输出图像的dpi,默认为300 | |
| quality | integer | 非必须 | 90 | 设置图像的质量，默认为90 | |
| id | integer | 非必须 | 创建ID | ||
| name | string | 非必须 | 名称 | ||
| businessKey | integer | 非必须 | 业务字段，业务方可以自定义 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 非必须 | |||
| message | string | 非必须 | |||
| data | integer | 非必须 | 该值为任务ID。在“异步任务API调用”中，通过传入该值，得到生成结果 | ||
| requestId | string | 非必须 |
交互式分割-选区交互
基本信息
Path： /sas/algorithm/run_iteractive_segmentation
Method： POST
接口描述：
功能描述
调用者提供图片，通过添加保留点和去除点可选择图片中的区域，添加保留点后会自动识别保留点周边的区域，并生成对应选区，添加删除点后会自动识别删除点周边的区域，并删除对应区域的选区
图片要求
图片格式：'.JPG', '.PNG', '.JPEG', '.BMP', '.WEBP'
图片大小：不超过5MB
接口说明
api_name: sas_algorithm_run_iteractive_segmentation
接口为同步接口，无需异步获取
功能示例
1.原图 2.添加‘保留点’
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| image | string | 必须 | 参考图 oss path | ||
| fg_points | string | 非必须 | 保留点（归一化0～1相对值），包含历史有效点 字符串x,y@x,y@x,y格式。原点（0,0)左上角，右下角(1,1)。 | ||
| bg_points | string | 非必须 | 去除点（归一化0～1相对值），包含历史有效点 字符串x,y@x,y@x,y格式。原点（0,0)左上角，右下角(1,1)。 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 非必须 | |||
| message | string | 非必须 | |||
| data | object | 非必须 | |||
| ├─ mask | string | 非必须 | 输出mask，0～255二值图 | ||
| ├─ view_image | string | 非必须 | 展示图，png透明底 | ||
| requestId | string | 非必须 |
交互式分割-自动分割
基本信息
Path： /sas/algorithm/run_auto_segmentation
Method： POST
接口描述：
功能描述
调用者提供图片，可识别图片中的款式主体并生成对应选区，并且根据自身需求可进行针对性的识别，设置对应参数后便只会识别参数设置的内容，不设置则默认识别全部
图片要求
图片格式：'.JPG', '.PNG', '.JPEG', '.BMP', '.WEBP'
图片大小：不超过5MB
接口说明
api_name: sas_algorithm_run_auto_segmentation
接口为同步接口，无需异步获取
功能示例
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json |
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| image | string | 必须 | 参考图 oss path | ||
| read_from_url | boolean | 非必须 | 是否读图片 path | ||
| fg_caption | string | 非必须 | 分割上衣，就输入 upper cloth;分割裤子，就输入 pants;分割裙子，就输入 skirt | ||
| rootCategory | string | 必须 | 一级分类 | ||
| id | integer | 非必须 | 创建ID | ||
| name | string | 非必须 | 名称 | ||
| category | string | 非必须 | 类目词 | ||
| material | string | 非必须 | 材质词 | ||
| menuCode | string | 非必须 | 菜单code | ||
| businessKey | integer | 非必须 | 业务字段，业务方可以自定义 |
返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
|---|---|---|---|---|---|
| code | integer | 非必须 | |||
| message | string | 非必须 | |||
| data | object | 非必须 | |||
| ├─ mask | string | 非必须 | 输出mask，0～255二值图 | ||
| ├─ view_image | string | 非必须 | 展示图，png透明底 | ||
| requestId | string | 非必须 |