图像到图像/遮蔽

开发环境

POST

v1/generation/{engine_id}/image-to-image/masking

使用蒙版有选择地修改图像的部分。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://dev-cn.your-api-server.comv1/generation//image-to-image/masking?Accept&Organization	=org-123456&Stability-Client-ID	=my-great-plugin&Stability-Client-Version	=1.2.1' \
--form 'text_prompts=""' \
--form 'init_image=""' \
--form 'mask_source=""' \
--form 'mask_image=""' \
--form 'cfg_scale=""' \
--form 'clip_guidance_preset=""' \
--form 'sampler=""' \
--form 'samples=""' \
--form 'seed=""' \
--form 'steps=""' \
--form 'style_preset=""' \
--form 'extras=""'

响应示例

200 - 示例 1

{
  "artifacts": [
    [
      {
        "base64": "string",
        "finishReason": "string",
        "seed": 0
      }
    ]
  ]
}

请求参数

Path 参数

engine_id

string

必需

Query 参数

string

可选

响应的格式。对于 JSON，请将其留空；对于 PNG 图像，将其设置为“image/png”。

Organization

string

可选

允许将请求范围限定为用户默认组织之外的组织。如果未提供，将使用用户的默认组织。

示例值:

org-123456

Stability-Client-ID

string

可选

用于识别请求的来源，例如客户端应用程序或子组织。可选，但为了组织清晰而推荐。

示例值:

my-great-plugin

Stability-Client-Version

string

可选

用于识别发出请求的应用程序或服务的版本。可选，但为了组织清晰而推荐。

示例值:

1.2.1

Body 参数multipart/form-data

text_prompts

array[string]

必需

用于生成的一组文本提示。

由于数组在multipart/form-data请求中的表示方式，提示必须遵循格式text_prompts[index][text|weight]，其中index一些整数用于将文本和权重联系在一起。虽然index不必是连续的，但重复的条目将覆盖以前的条目，因此建议使用顺序索引。

给定一个文本提示，其文本A lighthouse on a cliff和权重为0.5，它将表示为：

text_prompts[0][text]: "A lighthouse on a cliff"
text_prompts[0][weight]: 0.5

要向该请求添加另一个提示，只需在 new 下提供值index：

text_prompts[0][text]: "A lighthouse on a cliff"
text_prompts[0][weight]: 0.5
text_prompts[1][text]: "land, ground, dirt, grass"
text_prompts[1][weight]: -0.9

init_image

string

必需

用于初始化扩散过程的图像，代替随机噪声。

mask_source

string

必需

对于任何给定的像素，掩模确定线性尺度上的生成强度。此参数确定从何处获取掩码：

MASK_IMAGE_WHITE会使用 mask_image 的白色像素作为掩模，其中白色像素被完全替换，黑色像素不变

MASK_IMAGE_BLACK会使用 mask_image 的黑色像素作为掩模，其中黑色像素被完全替换，白色像素不变

INIT_IMAGE_ALPHA将使用 init_image 的 alpha 通道作为遮罩，其中完全透明的像素被完全替换，完全不透明的像素保持不变

mask_image

string

必需

可选的灰度蒙版，可以影响哪些像素适合扩散以及扩散的强度。必须与的尺寸相同init_image。使用该mask_source选项指定是否应修复白色或黑色像素。

cfg_scale

number

可选

扩散过程遵循提示文本的严格程度（值越高，图像越接近提示）

clip_guidance_preset

string

可选

sampler

string

可选

扩散过程使用哪个采样器。如果省略此值，我们将自动为您选择合适的采样器。

samples

integer

可选

要生成的图像数量

seed

integer

可选

随机噪声种子（忽略此选项或用于0随机种子）

steps

integer

可选

要运行的扩散步骤数。

style_preset

string

可选

传入样式预设以引导图像模型走向特定样式。此样式预设列表可能会发生变化。

extras

string

可选

传递给引擎的额外参数。这些参数用于开发中或实验性功能，可能会在没有警告的情况下发生变化，因此请谨慎使用。

返回响应

🟢200成功

application/json

Body

artifacts

array [array]

必需

object

可选

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🔴500服务器错误

修改于 2023-12-14 08:22:40

图像到图像/高档

安装