神奇涂抹-API接入

神奇涂抹可对受到损坏的图像进行修复重建或者去除图像中的多余物体，恢复图像的原始状态，同时保证图像达到最理想的艺术效果。

任务创建

根据输入参数创建算法任务并返回任务id

请求地址

/v3/pic/aigc-sd15/batch

请求参数

Method

post

Header

Field	Required	Type	Value	Description
Content-Type	YES	string	application/json
Authorization	YES	string	Basic xxxxxxxxx	用户使用appkey和secret拼接出来的Basic base64(appkey:appsecret)

Body

Field	Son Field	Required	Type	Value	Description
text	-	YES	string		替换涂抹区域图像的文字描述
scale	-	NO	string		尺寸 1:1 / 16:9 / 9:16/4:3/3:4 默认1:1
image_url	-	NO	string		可下载图片文件链接
mask_url	-	NO	string		涂抹水印图, 分辨率与image_url的图片一致, 为黑底白图
step	-	YES	number		默认值, 越大越慢, 取值范围1~30
cv_scale	-	YES	number		文本相似度 8.0 (0-30)
sampler	-	YES	string		采样方式 默认"DDIM" 选填"PLMS"
sr	-	NO	boolean		是否超分
strength	-	YES	number		构图相似度 0.8 (0-1.0)
np	-	NO	string		反向词
out_num	-	YES	integer		输出图片张数, 默认 1 张, 最大值 4, 按张数收费
disable_translate	-	NO	boolean		是否翻译
disable_text_sensitive	-	NO	boolean		是否开启文本敏感词检测
disable_picture_sensitive	-	NO	boolean		是否开启图片敏感词检测

示例代码

{
  "text": "natural landscape",
  "scale": "1:1",
  "image_url": "xxx.jpg",
  "mask_url": "xxx.jpg",
  "step": 7,
  "cv_scale": 8.0,
  "sampler": "DDIM",
  "sr": true,
  "strength": 0.8,
  "np": "body",
  "out_num": 1,
  "disable_translate": false,
  "disable_text_sensitive": false,
  "disable_picture_sensitive": false
}

输入文件限制

图片格式	图片体积	图片分辨率	图像纵横比
PNG JPG JPEG BMP	不超过50 MB	大于256×256px，小于5000x5000px	纵横比在4:1以内

返回数据

Body

Field	Son Field	Required	Type	Value	Description
code	-	YES	number		状态码
msg	-	YES	string		请求信息
data	-	YES	object		响应数据
-	task_id	YES	string		任务id

示例代码

{
  "code": 0,
  "msg": "",
  "data": {
    "task_id": "6a4eab77-be30-430a-bf0e-3048042a34ef"
  }
}

结果获取

根据任务id 请求任务处理结果

请求地址

/v3/pic/aigc-sd15/result

请求参数

Method

post

Header

Field	Required	Type	Value	Description
Content-Type	YES	string	application/json
Authorization	YES	string	Basic xxxxxxxxx	用户使用appkey和secret拼接出来的Basic base64(appkey:appsecret)

Body

Field	Son Field	Required	Type	Value	Description
task_id	-	YES	string		任务id

返回数据

Body

Field	Son Field	Required	Type	Value	Description
code	-	YES	number		状态码
msg	-	YES	string		请求信息
data	-	YES	object		响应数据
-	url	YES	string
-	status	YES	string		任务状态 状态：1：成功；2：失败；3：排队；4：处理中；5：文本敏感；6：图片敏感；7：超时; 8-余额不足
-	error	YES	string		错误信息
-	task_id	YES	string
-	cost	YES	string		返回时间
-	images	YES	string[]		生成的图片数组