文本到图像

开发环境

http://dev-cn.your-api-server.com

POST

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

从文本、现有图像或两者生成图像。

根据文本提示生成新图像

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://dev-cn.your-api-server.comv1/generation/stable-diffusion-v1-6/text-to-image?Accept&Organization=org-123456&Stability-Client-ID	=my-great-plugin&Stability-Client-Version	=1.2.1' \
--header 'Content-Type: application/json' \
--data-raw '{
    "text_prompts": [
      {
        "text": "A lighthouse on a cliff"
      }
    ],
    "cfg_scale": 7,
    "height": 1024,
    "width": 1024,
    "samples": 1,
    "steps": 30
  }'

响应示例

200 - 成功示例

{
  "artifacts": [
    [
      {
        "base64": "...very long string...",
        "finishReason": "SUCCESS",
        "seed": 1050625087
      },
      {
        "base64": "...very long string...",
        "finishReason": "CONTENT_FILTERED",
        "seed": 1229191277
      }
    ]
  ]
}

请求参数

Path 参数

engine_id

string

必需

示例值:

stable-diffusion-v1-6

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 参数application/json

text_prompts

array [object {1}]

必需

对象数组( TextPrompts )非空用于生成的一组文本提示。给定一个文本提示，其文本A lighthouse on a cliff和权重为0.5，它将表示为： "text_prompts": [ { "text": "A lighthouse on a cliff", "weight": 0.5 } ]

text

string

提示本身

可选

cfg_scale

integer

可选

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

height

integer

可选

要生成的图像的高度（以像素为单位），增量可被 64 整除。发动机特定尺寸验证： SDXL Beta：必须介于 128x128 和 512x896（或 896x512）之间；只有一维可以大于 512。 SDXL v0.9：必须是 1024x1024、1152x896、1216x832、1344x768、1536x640、640x1536、768x1344、832x1216 或 896x1152 之一 SDXL v1.0：与SDXL v0.9相同 SD v1.6：必须介于 320x320 和 1536x1536 之间

width

integer

可选

要生成的图像的宽度（以像素为单位），增量可被 64 整除。发动机特定尺寸验证： SDXL Beta：必须介于 128x128 和 512x896（或 896x512）之间；只有一维可以大于 512。 SDXL v0.9：必须是 1024x1024、1152x896、1216x832、1344x768、1536x640、640x1536、768x1344、832x1216 或 896x1152 之一 SDXL v1.0：与SDXL v0.9相同 SD v1.6：必须介于 320x320 和 1536x1536 之间

samples

integer

要生成的图像数量

可选

steps

integer

可选

要运行的扩散步骤数。

示例

返回响应

🟢200成功

application/json

Body

artifacts

array [array]

必需

object

可选

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🔴500服务器错误

列表

图像到图像