图片生成 API

请求方法

POST

请求地址

打开控制台，进入 我的推理服务，找到对应的推理服务，复制下图所示位置的请求地址：

CURL 示例

实际使用时，请务必替换下列location变量为上图中所复制的url地址：

curl --location '{填入启动的推理服务的地址，如上图红框内所示，删除花括号}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {填入API Key，删除花括号}' \
--data '{
    "model_name": "{填入推理服务所对应的模型名称，具体格式为model_name/model_version，删除花括号}",
    "prompt": "a photo of a sunflower, photography, studio portrait, 50mm lens",
    "negative_prompt": "",
    "height": 512,
    "width": 512,
    "sampler": "DPM++_2M_karras",
    "steps": 20,
    "cfg_scale": 7.5,
    "batch_size": 1,
    "clip_skip": 0,
    "eta": 0,
    "seed": -1
}'

请求 Body 参数（application/json）

参数名	参数类型	取值范围	参数释义	是否必填
model_id	int	大于 `0` 的正整数	模型 id，对应模型名称请求模型列表接口获取	是
model_name	string	由model_name/model_version组合成的模型名称, 如：启动的是SDXL的v1.0版本模型，则请求时此参数为"SDXL/v1.0"	模型名，对应模型名称请求模型列表接口获取	是
prompt	string	不超过 `1000` 个字符	生成图片的提示词	否
negative_prompt	string	默认值：`空字符串` 不超过 `1000` 个字符	生成图片的反向提示词	否
height	int	默认值：`512` 取值范围：`[64, 1024]` 必须是 8 的倍数，如果不是则向下取最近的 8 的倍数	生成图片高度	否
width	int	默认值：`512` 取值范围：`[64, 1024]` 必须是 8 的倍数，如果不是则向下取最近的 8 的倍数	生成图片宽度	否
sampler	string	默认值：`none` 取值范围： `DPM++_SDE` `DPM++_2S_a` `DPM++_2S_a_karras` `DPM++_2M` `DPM++_2M_karras` `DPM++_2M_SDE` `DPM++_2M_SDE_karras` `DPM2` `DPM2_karras` `DPM2_a` `DPM2_a_karras` `Euler` `DPM2_a` `Heun` `DEIS` `UniPC` `DPM_SDE` `LMS` `LMS_karras` `DDIM` `PNDM` `DDPM` `DPM2` `Euler_a` `Euler_SGMUniform` `DPM++_2M_karras_EDM`	采样器	否
steps	int	默认值：`20` 取值范围：`[20, 50]`	降噪步数	否
cfg_scale	float	默认值：`7.5` 取值范围：`[1, 13]`	指导权重数值越大生成的图片更接近于 Prompt 或原始图片	否
seed	int	默认值：`-1` 取值范围：`[-1, 4294967294]` 当值为`-1`时，seed 为随机数	随机种子	否
batch_size	int	默认值：`1` 取值范围：`[1, 4]`	批次出图数量	否
clip_skip	int	默认值：`0` 取值范围：`[1, 12]`	生成图像的风格和细节程度较低的 Clip Skip 数值可以产生更加详细和精确的图像较高的 Clip Skip 数值则会导致 AI 在生成图像时省略更多的细节	否
eta	float	默认值：`0` 取值范围：`[0, 1]`	噪声倍数	否
vae	string	默认值：`空字符串` 取值范围： `vae-ft-mse-840000-ema-pruned` 如不填则匹配对应的 vae	变分自编码器	否
img2img_params	Image2ImageInfo	默认值：`空`	图生图参数	否
inpainting_params	InpaintingInfo	默认值：`空`	局部重绘参数	否
lora_params	[]LoraInfo	默认值：`空`	LoRA 参数	否
controlnet_params	[]ControlNetInfo	默认值：`空`	ControlNet 参数	否
pos_embeddings	[]EmbeddingInfo	默认值：`空`	正向提示词 embeddings	否
neg_embeddings	[]EmbeddingInfo	默认值：`空`	负向提示词 embeddings	否
adetailer_params	[]AdetailerInfo	默认值：`空`	Adetailer 参数	否
hrfix_params	HrfixInfo	默认值：`空`	超分参数	否
sdxl_style_params	SdxlStyleInfo	默认值：`空`	sdxl 风格参数	否
wd14tagger_params	Wd14TaggerInfo	默认值：`空`	图片生成标签参数	否
rembg_params	RembgInfo	默认值：`空`	去除背景参数	否
safety_params	SafetyInfo	默认值：`空`	图片安全监测参数	否

Image2ImageInfo

参数名	参数类型	取值范围	参数释义	是否必填
image_url	string	默认值：``	初始图片 URL	是
denoising_strength	float	[0, 1]	去噪强度	否
resize_mode	int	[0, 2]	缩放模式: 0:按长宽 1:按比例等比缩放 2:按长宽最大值等比缩放	否
resize_scale	float	[0.05, 4]	缩放比例	否

InpaintingInfo

参数名	参数类型	取值范围	参数释义	是否必填
mask_image_url	string	默认值：``	遮罩图片 URL	是

EmbeddingInfo

参数名	参数类型	取值范围	参数释义	是否必填
id	int		模型 id(官方支持的 embedding 只需填此字段)	否
name	string		模型名称(自行上传到 custom 文件夹下的 embedding 只需填此字段)	否

LoraInfo

参数名	参数类型	取值范围	参数释义	是否必填
id	int		模型 id(官方支持的 lora 模型只需填此字段)	否
name	string		模型名称(自行上传到 custom 文件夹下的 lora 只需填此字段)	否
weight	float	[0, 1]	模型权重	是

ControlNetInfo

其中type/model/preprocessor三个参数的对应方式与sdwebui保持一致

参数名	参数类型	取值范围	参数释义	是否必填
type	string	`none` `canny` `depth` `openpose` `normalbae` `scribble` `tile` `softedge` `qrcode` `segmentation` `lineart` `mlsd` `shuffle` `ip2p` `instantid` `ipadapter`	类型	是
model	string	`control_v11p_sd15_canny` `control_v11p_sd15_openpose` `control_v11f1p_sd15_depth` `control_v11p_sd15_normalbae` `control_v11f1e_sd15_tile` `control_v11p_sd15_scribble` `control_v1p_sd15_qrcode_monster_v2` `control_v11p_sd15_seg` `control_v11p_sd15_softedge` `control_v11p_sd15_lineart` `control_v11p_sd15_mlsd` `control_v11e_sd15_shuffle` `control_v11e_sd15_ip2p` `ip-adapter_sd15` `kohya_controllllite_xl_canny_anime` `diffusers_xl_canny_full` `diffusers_xl_canny_mid` `diffusers_xl_canny_small` `diffusers_xl_depth_full` `diffusers_controlnet-canny-scribble-integrated-sdxl-v2-fp16_full` `diffusers_xl_depth_mid` `diffusers_xl_depth_small` `ip-adapter_xl` `t2i-adapter_diffusers_xl_lineart` `t2i-adapter_diffusers_xl_openpose` `kohya_controllllite_xl_openpose_anime_v2` `kohya_controllllite_xl_depth_anime` `t2i-adapter_diffusers_xl_sketch` `sargezt_xl_softedge` `kohya_controllllite_xl_blur` `kohya_controllllite_xl_scribble_anime`	模型	是
preprocessor	string	`none` `canny` `invert (from white bg & black line)`或`invert` `openpose_full` `openpose` `openpose_hand` `openpose_face` `openpose_faceonly` `dw_openpose_full` `depth_zoe` `depth_leres++` `depth_leres` `depth_midas` `normal_bae` `normal_midas` `tile_resample` `blur_gaussian` `scribble_hed` `t2ia_sketch_pidi` `scribble_xdog` `scribble_pidinet` `seg_ofade20k` `seg_ofcoco` `seg_ufade20k` `softedge_pidinet` `softedge_pidisafe` `softedge_hed` `softedge_hedsafe` `softedge_teed` `softedge_anyline` `lineart_standard` `lineart_realistic` `lineart_coarse` `lineart_anime` `lineart_anime_denoise` `mlsd` `shuffle` `lineart_t2i` `openpose_t2i` `pidinet_t2i`	模型	是
image_url	string	默认值：``	初始图片 URL	否
mask_url	string	默认值：``	遮罩图片 URL	否
control_weight	float	默认值：`1.0` 取值范围：[0, 2]	控制权重	否
starting_control_step	int	默认值：`0.0` 取值范围：[0, 1]	开始控制步数	否
ending_control_step	int	默认值：`1.0` 取值范围：[0, 1]	结束控制步数	否
down_sampling_rate	int	默认值：`1.0` 取值范围：[0, 8]	下采样率	否
control_mode	bool	默认值：`false`	控制模式	否
low_threshold	int	默认值：`100` 取值范围：[0, 255]	低阈值	否
high_threshold	int	默认值：`200` 取值范围：[0, 255]	高阈值	否
sigma	int	默认值：`9.0` 取值范围：[0.01, 64]	sigma 值	否
preprocessor_resolution	int	默认值：`512` 取值范围：[64, 1344]	前处理分辨率	否

HrfixInfo

参数名	参数类型	取值范围	参数释义	是否必填
upscaler	string	`Latent` `Latent (antialiased)` `Latent (bicubic)` `Latent (bicubic antialiased)` `Latent (nearest)` `Latent (nearest-exact)` `ESRGAN_4x` `4x-UltraSharp` `RealESRGAN_x4` `RealESRGAN_x4plus_anime_6B` `Lanczos` `Nearest`	模型名称	是
image_url	string		单独使用此功能时上传的图片地址	否
denoising_strength	float	默认值：`0.5` 取值范围：[0.0, 1.0]	超分时的降噪系数	否
super_size_multiple	float	默认值：`2.0` 取值范围：[1.0, 4.0]	超分倍数	否
hires_steps	int	默认值：`20` 取值范围：[1, 50]	超分时的步数	否

AdetailerInfo

参数名	参数类型	取值范围	参数释义	是否必填
model_name	string	`face_yolov8n.pt` `hand_yolov8n.pt` `person_yolov8s-seg.pt` `deepfashion2_yolov8s-seg.pt` `face_yolov8s.pt` `person_yolov8n-seg.pt` `face_yolov8m.pt` `hand_yolov8s.pt` `face_yolov8n_v2.pt` `person_yolov8m-seg.pt` `mediapipe_face_short` `mediapipe_face_full` `mediapipe_face_mesh` `mediapipe_face_mesh_eyes_only`	面部修复使用的模型	是
prompt	string	默认值：``	面部修复时使用的提示词	否
negative_prompt	string	默认值：``	面部修复时使用的负向提示词	否
confidence	float	默认值：`0.3` 取值范围：[0, 1]	面部修复时使用的检测阈值	否
mask_k_largest	int	默认值：`0` 取值范围：[0, 10]	只处理阈值最高的 k 个	否
mask_min_ratio	float	默认值：`0.0` 取值范围：[0, 1]	蒙版的最小比例	否
mask_max_ratio	float	默认值：`1.0` 取值范围：[0, 1]	蒙版的最大比例	否
dilate_erode	int	默认值：`4` 取值范围：[-128, 128]	蒙版的腐蚀膨胀参数	否
x_offset	int	默认值：`0` 取值范围：[-200, 200]	蒙版 x 轴偏移量	否
y_offset	int	默认值：`0` 取值范围：[-200, 200]	蒙版 y 轴偏移量	否
mask_merge_invert	string	`None` `Merge` `Merge and Invert`	蒙版合并模式	否
mask_blur	int	默认值：`4` 取值范围：[0, 64]	蒙版模糊程度	否
denoising_strength	float	默认值：`0.4` 取值范围：[0.0, 1.0]	降噪系数	否
inpaint_only_masked	bool	默认值：`true`	只处理蒙版	否
steps	int	默认值：`50`	面部修复所需的步数	否
cfg_scale	float	默认值：`7.0` 取值范围：[0.0, 30.0]	面部修复引导系数	否
checkpoint	string	默认值：``	面部修复的 ckpt 模型文件，默认空	否
vae	string	默认值：``	面部修复的 vae 模型文件，默认空	否
sampler	string	默认值：``	面部修复的 sampler，默认空	否
noise_multiplier	float	默认值：`1.0` 取值范围：[0.5, 1.5]	噪声系数	否
clip_skip	int	默认值：`1` 取值范围：[1, 12]	面部修复的 clip_skip 值	否

SdxlStyleInfo

参数名	参数类型	取值范围	参数释义	是否必填
style_name	string	`3D Model` `Abstract` `Advertising` `Alien` `Analog Film` `Anime` `Architectural` `Cinematic` `Collage` `Comic Book` `Craft Clay` `Cubist` `Digital Art` `Disco` `Dreamscape` `Dystopian` `Enhance` `Fairy Tale` `Fantasy Art` `Fighting Game` `Film Noir` `Flat Papercut` `Food Photography` `GTA` `Gothic` `Graffiti` `Grunge` `HDR` `Horror` `Hyperrealism` `Impressionist` `Isometric Style` `Kirigami` `Legend of Zelda` `Line Art` `Long Exposure` `Lowpoly` `Minecraft` `Minimalist` `Monochrome` `Nautical` `Neon Noir` `Neon Punk` `Origami` `Paper Mache` `Paper Quilling` `Papercut Collage` `Papercut Shadow Box` `Photographic` `Pixel Art` `Pointillism` `Pokémon` `Pop Art` `Psychedelic` `RPG Fantasy Game` `Real Estate` `Renaissance` `Retro Arcade` `Retro Game` `Silhouette` `Space` `Stacked Papercut` `Stained Glass` `Steampunk` `Strategy Game` `Street Fighter` `Super Mario` `Surrealist` `Techwear Fashion` `Texture` `Thick Layered Papercut` `Tilt-Shift` `Tribal` `Typography` `Watercolor` `Zentangle` `base`	风格名称	否

RembgInfo

参数名	参数类型	取值范围	参数释义	是否必填
model	string	`RMBG-1.4` `u2net` `isnet-general-use` `u2netp` `u2net_human_seg` `u2net_cloth_seg` `silueta` `isnet-general-use` `isnet-anime`	模型名称	是
only_mask	bool	默认值：`false`	是否只输出蒙板图	否
alpha_matting	bool	默认值：`false`	是否启用 Alpha 描述	否
alpha_matting_foreground_threshold	int	默认值：`240` 取值范围：[0, 255]	用于 Alpha 描述的前景阈值（前景颜色与背景颜色的最小差异）	否
alpha_matting_background_threshold	int	默认值：`10` 取值范围：[0, 255]	用于 Alpha 描述的背景阈值（背景颜色与背景颜色的最小差异）	否
alpha_matting_erode_size	int	默认值：`10` 取值范围：[0, 40]	Alpha 描述的侵蚀大小（以像素为单位）	否
image_url	string	默认值：``	单独使用此功能时上传的图片地址	否

Wd14TaggerInfo

参数名	参数类型	取值范围	参数释义	是否必填
model_name	string	`wd-v1-4-convnext-tagger-v2` `wd-v1-4-convnext-tagger` `wd-v1-4-convnextv2-tagger-v2` `wd-v1-4-moat-tagger-v2` `wd-v1-4-vit-tagger-v2`	模型名称	是
image_url	string	默认值：``	单独使用此功能时上传的图片地址	否
threshold	float	默认值：`0.35` 取值范围：[0, 1.0]	标签被视为有效的分数	否
character_threshold	float	默认值：`0.85` 取值范围：[0.0, 1.0]	角色标签被视为有效的分数	否
exclude_tags	string	默认值：``	不应包含在结果中的标签（用逗号分隔的标签列表）	否
replace_underscore	bool	默认值：`false`	是否替换下划线为空格	否
trailing_comma	bool	默认值：`false`	是否在输出的标签列表结尾添加一个额外的逗号	否

SafetyInfo

参数名	参数类型	取值范围	参数释义	是否必填
do_safety_checker	bool	默认值：`false`	是否对图片进行安全检测	否
sensitivity	float	默认值：`0.5` 取值范围：[0.0, 1.0]	图片安全监测的敏感度	否

返回响应（json）

参数名	参数类型	参数释义
request_id	string	返回的请求 id，根据任务 ID 请求接口获取结果

请求方法​

请求地址​

请求 Body 参数（application/json）​

Image2ImageInfo​

InpaintingInfo​

EmbeddingInfo​

LoraInfo​

ControlNetInfo​

HrfixInfo​

AdetailerInfo​

SdxlStyleInfo​

RembgInfo​

Wd14TaggerInfo​

SafetyInfo​

返回响应（json）​

请求方法

请求地址

请求 Body 参数（application/json）

Image2ImageInfo

InpaintingInfo

EmbeddingInfo

LoraInfo

ControlNetInfo

HrfixInfo

AdetailerInfo

SdxlStyleInfo

RembgInfo

Wd14TaggerInfo

SafetyInfo

返回响应（json）