👋 欢迎

Stable Diffusion V3 API 具有以下功能：

• 更快的速度;
• 图像填充(Inpainting);
• 图像到图像(Image 2 Image);
• 负面提示(Negative Prompts)。

Stable Diffusion API 采用 REST 设计。我们的 API 使用可预测的面向资源的 URL,接受表单编码的请求体,返回 JSON 编码的响应,并使用标准的 HTTP 响应代码、认证和动词。

Stable Diffusion API 配备了 NSFW 检查器。任何被检测为 NSFW 的图像都会被替换为空白图像。

:::danger
请注意您的图像内容，Stable Diffusion 有一个过滤系统来删除任何儿童色情内容。多次尝试将导致帐户被暂停。
:::

Stable Diffusion API 使用密钥（API Key）来验证请求。请将您从 API 设置页面获得的密钥传递给请求体（密钥跟随请求体 body 来发送请求）,并根据所有端点流程进行操作。

发送带有数据和链接的 JSON POST 请求。

:::caution
不要以原始格式发送文件，而是发送可公开访问的链接。
:::

所有 API 请求均由密钥授权。您可以通过 注册 获得一份。

:::tip
如果你不明白如何调试 Stable Diffusion API，你可以参考这篇教程来入门：Stable Diffusion API 在线调试教程
:::

API的特点

1. 通过一次 API 调用即可使用 100 多个模型生成图像。
2. 使用多 lora 模型
3. 使用嵌入模型
4. 使用控制网络模型
5. 使用多控制网络模型
6. 支持图像上采样
7. 高分辨率修复
8. 多语言支持
9. 支持自注意力处理
10. 支持模型训练
11. 支持Clip修复
12. Base64 支持

:::caution
所有 API 请求都需要在 header 中传入参数。请确保像下面的例子一样在 header 中传入 'Content-Type: application/json':

--header 'Content-Type: application/json'

:::

请点击以下链接了解有关图像稳定扩散 API 接口的更多信息：

• Stable Diffusion API；
• Dreambooth 微调；
• Dreambooth API V4；
• 文字转视频；
• ControlNet；
• 企业计划；
• Dreambooth 沙盒 API；
• 图像编辑。

:::info
请访问我们的 **YouTube 频道**，观看 Stable Diffusion API 的使用示例。
:::

可能的错误响应

下面列出了使用稳定扩散 API 时可能发生的最常见错误。

速率限制

当多次发送同一个请求时，会返回此错误。

{
    "status": "error",
    "message": "Rate limit exceeded",
    "tips": "you are sending same request multiple times, spam filter is enabled, please wait for 30 seconds and try again"
}

无效密钥

当请求认证时使用的API key不合法时，会返回该错误。

{
    "status": "error",
    "message": "Invalid Api Key",
    "tip": "1. Make sure you are passing Content-Type: application/json in header. 2. Make sure you are doing POST request with valid JSON. 3. Make sure your JSON does not have error, use jsonlint to validate json array. 4. Make sure you have valid API key."
}

响应失败

当请求由于某种原因失败时，会返回此错误。

{
    "status": "failed",
    "id": "",
    "message": "Failed, Try Again",
    "output": ""
}

验证错误

如果未设置必填字段之一，则会返回此错误。在本例中，提示字段未设置：

{
    "status": "error",
    "message": {
        "prompt": [
            "The prompt field is required."
        ]
    }
}

当需要 model_id 的端点尚未填写 model_id 时，会返回此错误。

{
    "status": "error",
    "message": "Model id not found"
}