Stability AI
  1. V1/生成
Stability AI
  • 发布说明
  • 入门
    • 🔒 认证
    • 💰 积分+账单
    • Python gRPC SDK
    • TypeScript gRPC 客户端
  • REST API
    • Stability.ai REST API (v1 )
    • V1/用户
      • 账户
      • 平衡
    • V1/引擎
      • 列表
    • V1/生成
      • 文本到图像
        POST
      • 图像到图像
        POST
      • 图像到图像/高档
        POST
      • 图像到图像/遮蔽
        POST
  • 集成
    • Blender
      • 安装
      • 开始使用
      • 渲染到图像
      • 生成纹理
      • 动画片
      • 稳定性
  1. V1/生成

图像到图像

开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
v1/generation/{engine_id}/image-to-image
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.comv1/generation/stable-diffusion-v1-6/image-to-image?Accept	&Organization	=org-123456&Stability-Client-ID	=my-great-plugin&Stability-Client-Version	=1.2.1' \
--form 'text_prompts=""' \
--form 'init_image=""' \
--form 'init_image_mode=""' \
--form 'image_strength=""' \
--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 
必需
示例值:
stable-diffusion-v1-6
Query 参数
Accept
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 
必需
用于初始化扩散过程的图像,代替随机噪声。
init_image_mode
string 
可选
是否使用image_strength或控制对结果的step_schedule_*影响程度。init_image
image_strength
number 
可选
init_image对扩散过程的影响有多大。接近 的值1将生成与 非常相似的图像init_image,而接近 的值0将生成与 非常不同的图像init_image。其行为旨在反映 DreamStudio 的“图像强度”滑块。
该参数只是另一种设置方式step_schedule_start,通过计算完成1 - image_strength。例如,传递 35% 的图像强度 ( 0.35) 将导致step_schedule_start的0.65。
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服务器错误
上一页
文本到图像
下一页
图像到图像/高档
Built with