稳定平台（中文翻译）即 Stability 平台

引言

        稳定平台 API 提供了一系列工具，用于生成、编辑和管理数字内容，包括利用先进的 AI 技术生成图像和视频。该服务旨在简化创建高质量数字内容的过程，并提供了各种功能以满足不同需求。

API 版本

        截至 2024 年 3 月，REST v2beta API 是稳定平台的主要服务。虽然旧版本的 API（gRPC、REST v1 和 REST v2alpha）将继续维护，但它们不会收到新功能。建议用户通过简单更改 URL 调用来过渡到 v2beta API。

速率限制

        该 API 每 10 秒允许最多 150 次请求。如果超过这个限制，您会收到 429 响应并暂停 60 秒。

提供的服务

        该 API 提供了多种服务来生成、编辑和升级图像和视频：

1. 图像生成: “稳定图像核心”服务根据文本提示生成图像，支持多种风格、分辨率和格式。还有从现有图像生成图像的选项，包括缩放和编辑功能。

2. 编辑: 该 API 提供了修复（填补或替换图像部分）、拓展（向特定方向扩展内容）以及搜索和替换等功能，可以用简单的语言来修改对象。

3. 升级: 升级功能增加了图像的分辨率，同时保留甚至增强了其质量。该服务特别适用于降级图像，将它们升级到 4K 分辨率。

4. 视频生成: API 还提供了从图像生成视频的工具，使其更容易从静态内容创建短动画或过渡效果。

        稳定平台 API 是一个多功能且强大的工具，可用于生成和编辑数字内容，使个人和组织更容易制作高质量的图像和视频。新的 v2beta API 提供了更多的功能，建议用户切换，以充分利用其潜力。对于任何问题或疑虑，该平台还提供了全面的支持和资源，以帮助用户充分利用这些服务。

功能概述

        稳定图像 API 提供了一系列工具，用于生成、编辑和管理数字图像。以下是主要功能的概述：

生成服务

        稳定图像 API 提供了多种生成工具，以生成新的图像或修改现有图像：

1. Stable Image Core: 该服务提供了高质量、快速的文本到图像生成。用户可以简单地输入描述、风格、场景或角色，并获得相应的图像。请求体可以包含多种参数，例如生成图像的长宽比、负面描述、随机种子、风格预设以及输出格式。

2. Stable Diffusion 3.0: 此服务使用 Stable Diffusion 3.0（SD3）或 Stable Diffusion 3.0 Turbo（SD3 Turbo）来生成图像。用户可以选择文本到图像或图像到图像的模式生成图像。此外，该服务提供了多种选项，以控制生成图像的模式、风格、负面描述等。

图像增强

        API 提供了图像增强工具，以增加现有图像的尺寸：

1. Creative Upscale: 该工具可以将 64x64 到 1MP 的图像放大到 4K 分辨率。适用于品质较低的图像，可以进行 20-40 倍放大，同时保留甚至增强图像质量。

2. Fetch Creative Upscale Result: 用户可以通过生成 ID 获取放大结果。放大结果存储 24 小时，之后删除。

图像编辑

        API 还提供了图像编辑工具，用于修改现有图像：

1. Inpaint: 此功能通过填充或替换图像中的特定区域来修改图像。用户可以提供面具图像或使用图像的 alpha 通道进行修改。

2. Outpaint: 该功能扩展了图像中的内容，以填补图像的任何方向。用户可以指定希望扩展的方向，并通过提示文本描述新增内容。

3. Search and Replace: 此功能无需面具图像，通过搜索描述找到目标对象并进行替换。

4. Remove Background: 该服务分离图像中的前景与背景，并去除背景。

总结

        稳定图像 API 提供了多种工具，以生成、增强和编辑数字图像。无论是文本到图像生成、放大图像，还是修改图像内容，该 API 都提供了丰富的选项，以满足不同需求。对于每项服务，用户可以通过提供 API 密钥来进行认证，并可以根据请求参数来获得理想的输出。

受控生成工具

1. Sketch: 该服务适合需要头脑风暴和频繁迭代的设计项目。它可以将粗略的手绘草图转换为精致的输出，并提供精确控制。对于非草图图像，它还可以通过利用图像中的轮廓线和边缘来详细控制最终外观。

   如何使用： 请使用 POST 请求调用此端点。请求体应采用 multipart/form-data 格式，并包括以下参数：

   • image: 用于指导生成的草图或图像。
   • prompt: 用于描述希望看到的图像内容。

   请求体还可以包括：

   • control_strength: 指定图像对生成的影响程度。
   • negative_prompt: 描述不希望出现在图像中的内容。
   • seed: 指导生成随机性的值。
   • output_format: 指定生成图像的内容类型。

2. Structure: 该服务擅长保持输入图像的结构，使其在场景再现或模型角色渲染等高级内容创作场景中尤为有用。

   如何使用： 请使用 POST 请求调用此端点。请求体应采用 multipart/form-data 格式，并包括：

   • image: 用于作为生成基础的图像。
   • prompt: 描述希望看到的图像内容。

   请求体还可以包括：

   • control_strength: 指定图像对生成的影响程度。
   • negative_prompt: 描述不希望出现在图像中的内容。
   • seed: 指导生成随机性的值。
   • output_format: 指定生成图像的内容类型。

        生成的图像的分辨率将与输入图像相匹配。每次成功生成收取 3 个积分，不会为失败的生成收费。

总结

        稳定图像 API 提供了精确控制的工具，以便根据现有图像或草图生成变体。Sketch 和 Structure 服务为用户提供了强大的工具，用于从手绘草图生成精细图像，或根据现有图像保持其结构生成新图像。这些服务可通过多种参数进行定制，以确保满足各种需求。

Sketch示例

import requests

# 确保您有正确的 API 密钥
api_key = "sk-MYAPIKEY" # 将其替换为你的实际 API 密钥

response = requests.post(
    "https://api.stability.ai/v2beta/stable-image/control/sketch",
    headers={
        "authorization": f"Bearer {api_key}",
        "accept": "image/*"
    },
    files={
        "image": open("./sketch.png", "rb")
    },
    data={
        "prompt": "a medieval castle on a hill",
        "control_strength": 0.7,
        "output_format": "webp"
    },
)

if response.status_code == 200:
    with open("./castle.webp", 'wb') as file:
        file.write(response.content)
else:
    raise Exception(str(response.json()))

Structure示例

import requests

# 确保您有正确的 API 密钥
api_key = "sk-MYAPIKEY" # 将其替换为你的实际 API 密钥

response = requests.post(
    "https://api.stability.ai/v2beta/stable-image/control/structure",
    headers={
        "authorization": f"Bearer {api_key}",
        "accept": "image/*"
    },
    files={
        "image": open("./cat-statue.png", "rb")
    },
    data={
        "prompt": "a well-manicured shrub in an English garden",
        "control_strength": 0.7,
        "output_format": "webp"
    },
)

if response.status_code == 200:
    with open("./shrub-in-a-garden.webp", 'wb') as file:
        file.write(response.content)
else:
    raise Exception(str(response.json()))