POST
/
v3
/
async
/
inpainting
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 用来控制图片中某部分内容被重新绘制。

请求头

Content-Type
string
required

枚举值: application/json

Authorization
string
required

Bearer 身份验证格式,例如:Bearer {{API 密钥}}。

请求体

extra
object

请求的可选 extra 参数

request
object
required
model_name
string
required

只支持 Inpainting 模型, 可以调用 /v3/model 接口并指定请求参数 filter.types=checkpoint&filter.is=inpainting=1 来获取可用模型列表。

image_base64
string
required

图片二进制的 base64 内容,图片长和宽均不超过 2048 像素,文件最大不超过 30 Mb。

mask_image_base64
string
required

图片二进制的 base64 内容,图片长和宽均不超过 2048 像素,文件最大不超过 30 Mb。

prompt
string
required

提示词,用于指导图像生成的文本输入,文本长度范围 [1, 1024]。

image_num
integer
required

生成图片的数量,取值范围:[1, 8]。

steps
integer
required

迭代步数,图片创建过程的迭代数,取值范围:[1, 100]。

guidance_scale
number(float32)
required

提示词引导系数,取值越大越接近于提示词描述,取值范围:[1, 30]。

sampler_name
string
required

指定采样器。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

mask_blur
integer

遮罩模糊尺寸(px),较低的值会导致边缘更清晰,保持遮罩区域和未遮罩区域之间的清晰划分。相反,较高的值会增加模糊效果,在边缘创建更平滑、更融合的过渡。此调整允许更好地控制遮罩与原始图像的视觉整合。取值范围:[0, 64]。

negative_prompt
string

反向提示词,文本长度范围 [0, 1024]。

sd_vae
string

模型 VAE(Variational Auto Encoder),可以调用 /v3/model 接口并指定请求参数 filter.types=vae 来获取可用模型列表。

seed
integer

随机数种子,稳定扩散产生噪声的数字,取值范围:>= -1。默认值为 -1。

loras
object[]

LoRA 模型,最多支持指定 5 个。

embeddings
object[]

Textual Inversion 模型,最多支持 5 个。

clip_skip
integer¦null

CLIP 跳过层数,取值范围:[1, 12]。

strength
number(float)¦null

控制对原始图片的调整幅度。总体来说,strength 值越大,调整幅度越大,和原始图片越不像。取值范围:(0, 1]。

inpainting_full_res
integer

当设置为 0 时,修复过程考虑整个图像,遮罩区域看起来更自然,或与整个图像能更好地融合。当设置为 1 时,仅填充遮罩区域,忽略未遮罩区域,但可能与原始背景看起来奇怪或不兼容。默认值为 0。Enum: 0, 1

inpainting_full_res_padding
integer

增加此值的缺点是可能会降低输出质量。取值范围:[0, 256],默认值为 8。

inpainting_mask_invert
integer

是否反转遮罩,为 1 时表示反转。默认值为 0。Enum: 0, 1

initial_noise_multiplier
number(float32)

可以帮助减少输出图像中的闪烁或不稳定性。取值范围:[0, 1.5]。默认值为 0.5。

响应参数

task_id
string
required

异步任务的 task_id。您应该使用该 task_id 请求 查询任务结果 API 以获取生成结果