局部重绘
curl --request POST \
--url https://api.ppinfra.com/v3/async/inpainting \
--header 'Authorization: <authorization>' \
--header 'Content-Type: <content-type>' \
--data '{
"extra": {
"response_image_type": "<string>"
},
"request": {
"model_name": "<string>",
"image_base64": "<string>",
"mask_image_base64": "<string>",
"prompt": "<string>",
"image_num": 123,
"steps": 123,
"guidance_scale": {},
"sampler_name": "<string>",
"mask_blur": 123,
"negative_prompt": "<string>",
"sd_vae": "<string>",
"seed": 123,
"loras": [
{
"model_name": "<string>",
"strength": {}
}
],
"embeddings": [
{
"model_name": "<string>"
}
],
"clip_skip": {},
"strength": {},
"inpainting_full_res": 123,
"inpainting_full_res_padding": 123,
"inpainting_mask_invert": 123,
"initial_noise_multiplier": {}
}
}'
{
"task_id": "<string>"
}
局部重绘 API 用来控制图片中某部分内容被重新绘制。
请求头
枚举值: application/json
Bearer 身份验证格式,例如:Bearer {{API 密钥}}。
请求体
只支持 Inpainting 模型, 可以调用 /v3/model 接口并指定请求参数 filter.types=checkpoint&filter.is=inpainting=1
来获取可用模型列表。
图片二进制的 base64 内容,图片长和宽均不超过 2048 像素,文件最大不超过 30 Mb。
图片二进制的 base64 内容,图片长和宽均不超过 2048 像素,文件最大不超过 30 Mb。
提示词,用于指导图像生成的文本输入,文本长度范围 [1, 1024]。
生成图片的数量,取值范围:[1, 8]。
迭代步数,图片创建过程的迭代数,取值范围:[1, 100]。
提示词引导系数,取值越大越接近于提示词描述,取值范围:[1, 30]。
指定采样器。Enum: 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,UniPC
遮罩模糊尺寸(px),较低的值会导致边缘更清晰,保持遮罩区域和未遮罩区域之间的清晰划分。相反,较高的值会增加模糊效果,在边缘创建更平滑、更融合的过渡。此调整允许更好地控制遮罩与原始图像的视觉整合。取值范围:[0, 64]。
反向提示词,文本长度范围 [0, 1024]。
模型 VAE(Variational Auto Encoder),可以调用 /v3/model 接口并指定请求参数 filter.types=vae
来获取可用模型列表。
随机数种子,稳定扩散产生噪声的数字,取值范围:>= -1。默认值为 -1。
Textual Inversion 模型,最多支持 5 个。
可以调用 /v3/model 接口并指定请求参数 filter.types=textualinversion
来获取可用模型列表。
CLIP 跳过层数,取值范围:[1, 12]。
控制对原始图片的调整幅度。总体来说,strength 值越大,调整幅度越大,和原始图片越不像。取值范围:(0, 1]。
当设置为 0 时,修复过程考虑整个图像,遮罩区域看起来更自然,或与整个图像能更好地融合。当设置为 1 时,仅填充遮罩区域,忽略未遮罩区域,但可能与原始背景看起来奇怪或不兼容。默认值为 0。Enum: 0, 1
增加此值的缺点是可能会降低输出质量。取值范围:[0, 256],默认值为 8。
是否反转遮罩,为 1 时表示反转。默认值为 0。Enum: 0, 1
可以帮助减少输出图像中的闪烁或不稳定性。取值范围:[0, 1.5]。默认值为 0.5。
响应参数
异步任务的 task_id。您应该使用该 task_id 请求 查询任务结果 API 以获取生成结果
curl --request POST \
--url https://api.ppinfra.com/v3/async/inpainting \
--header 'Authorization: <authorization>' \
--header 'Content-Type: <content-type>' \
--data '{
"extra": {
"response_image_type": "<string>"
},
"request": {
"model_name": "<string>",
"image_base64": "<string>",
"mask_image_base64": "<string>",
"prompt": "<string>",
"image_num": 123,
"steps": 123,
"guidance_scale": {},
"sampler_name": "<string>",
"mask_blur": 123,
"negative_prompt": "<string>",
"sd_vae": "<string>",
"seed": 123,
"loras": [
{
"model_name": "<string>",
"strength": {}
}
],
"embeddings": [
{
"model_name": "<string>"
}
],
"clip_skip": {},
"strength": {},
"inpainting_full_res": 123,
"inpainting_full_res_padding": 123,
"inpainting_mask_invert": 123,
"initial_noise_multiplier": {}
}
}'
{
"task_id": "<string>"
}