# AI绘画-API接入

根据多样的提示词和模型进行AI绘画

# 任务创建

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

# 请求地址

/v3/pic/aigc-novel/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	Description
prompt	-	YES	string	提示词, 想在画面中出现的, 逗号分隔
negative_prompt	-	NO	string	不要出现的内容,逗号分隔
image_url	-	NO	string	示例图, 传入可下载链接
denoising_strength	-	NO	number	float64类型 , 图片相似度(0~1.0) 默认0.8
seed	-	NO	integer	随机种子, 可以传入随机数字
steps	-	NO	integer	生成迭代步数默认值7 , 取值返回1~30, 越大越慢
cfg_scale	-	NO	number	float64类型，图文相关性，数字越大越贴近提示语的描述，一般在6~20之间
sampler_index	-	YES	string	采样器, 可选"Euler a", "Euler", "LMS", "Heun", "DPM2", "DPM2 a", "DPM++ 2S a", "DPM++ 2M", "DPM++ SDE", "DPM fast", "DPM adaptive", "LMS Karras", "DPM2 Karras", "DPM2 a Karras", "DPM++ 2S a Karras", "DPM++ 2M Karras", "DPM++ SDE Karras","DDIM","PLMS"
model	-	YES	integer	模型：1: anything 2:nice 3:hasdx 4:ultracolor 5:meinamix 6:bestqualitypastel，其他默认1
batch_size	-	YES	integer	图片张数, 默认1张, 最大值 4, 按张收费
scale	-	NO	string	画幅比例, "1:1" "16:9" "9:16" 三选一
is_translate	-	NO	boolean	是否需要翻译
width	-	YES	integer	默认0，最大768，宽高比需小于3。当width和height均不为0时，scale将不再生效。
height	-	YES	integer	默认0，最大768，宽高比需小于3。当width和height均不为0时，scale将不再生效。

示例代码

{
  "prompt": "natural landscape, 4k hd photo",
  "image_url": "pcloud/B9Qp60O99L1660135516000.png",
  "model": 1,
  "sampler_index": "Euler a",
  "batch_size": 2,
  "scale": "16:9",
  "seed": 91,
  "is_translate": true,
  "steps": 20,
  "cfg_scale": 9,
  "negative_prompt": "animal, people",
  "denoising_strength": 0.7,
  "width": 512,
  "height": 512
}

# 输入文件限制

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

# 返回数据

Body

Field	Son Field	Required	Type	Description
code	-	YES	number	状态码, 490027:余额不足错误
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-novel/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	Description
code	-	YES	number	状态码
msg	-	YES	string	请求信息
data	-	YES	object	响应数据
-	status	YES	string	任务状态状态：1：成功；2：失败；3：排队；4：处理中；5：文本敏感；6：图片敏感；7：超时; 8-余额不足
-	error	YES	string
-	task_id	YES	string
-	cost	YES	string
-	images	YES	string[]

← 简介简介 →