Stable Diffusion API 的文生图（Text to Image）端点允许你写正面提示词和负面提示词，正面提示词是针对你希望在图像中看到的内容，负面提示词是通过列出你不希望在生成的图像中看到的内容来完善你的描述。本文来介绍一下 Stable Diffusion API 中文生图（Text to Image）端点的使用，详情见下文。
Stable Diffusion API 文档 的在线地址为 https://stablediffusionapi.apifox.cn/ ，点击即可访问。项目中包含了 Stable Diffusion 官方提供的所有 API，你可以根据需要进行操作，里面会简要介绍某个功能模块怎么使用。一般推荐你将其克隆到 Apifox 里面，然后慢慢来进行调试。
如果你不知道怎么调试 API，你可以参考这篇文章：Stable Diffusion API 在线调试教程
Stable Diffusion 文生图（Text to Image）
Stable Diffusion V3 API Text2Image API 根据文本提示生成图像，该端点根据请求正文(Body)中传递的文本来生成并返回图像。
请求路径（Url）
向 https://stablediffusionapi.com/api/v3/text2img 端点发出 POST 请求，并将所需参数作为请求正文传递。
--request POST 'https://stablediffusionapi.com/api/v3/text2img' \请求参数（Body）
以下是发送请求时需要在 Body 中携带的请求参数：
参数 | 类型 | 必填 | 描述 |
key | string | 是 | 您的 API 密钥用于请求授权。 |
prompt | string | 是 | 文本提示，包含您想要在图像中生成的内容的描述。 |
negative_prompt | null | 是 | 图像中您不想要的项目。 |
width | string | 是 | 最大高度：宽度：1024x1024。 |
height | string | 是 | 最大高度：宽度：1024x1024。 |
samples | string | 是 | 作为响应返回的图像数量。最大值为 4。 |
num_inference_steps | string | 是 | 去噪步骤数。可用值：21、31、41、51。 |
safety_checker | string | 是 | NSFW 图像检查器。如果检测到此类图像，它将被空白图像替换。 |
enhance_prompt | string | 是 | 增强提示以获得更好的结果；默认值：是，选项：是/否。 |
seed | null | 是 | 种子用于重现结果，相同的种子将再次为您提供相同的图像。为随机数传递null 。 |
guidance_scale | number | 是 | 无分类器指导的量表（最小值：1；最大值：20）。 |
multi_lingual | string | 是 | 允许多语言提示生成图像。使用“no”作为默认英语。 |
panorama | string | 是 | 将此参数设置为“yes”以生成全景图像。 |
self_attention | string | 是 | 如果您想要高质量的图像，请将此参数设置为“yes”。在这种情况下，图像生成将花费更多时间。 |
upscale | string | 是 | 如果您想要将给定图像分辨率放大两倍 (2x)，请将此参数设置为“yes”。如果请求的分辨率为 512 x 512 像素，则生成的图像将为 1024 x 1024 像素。 |
embeddings_model | null | 是 | 这用于传递嵌入模型（embeddings_model_id）。 |
webhook | null | 是 | 设置 URL 以在图像生成完成后获取 POST API 调用。 |
track_id | null | 是 | 此 ID 在 Webhook API 调用的响应中返回。这将用于识别 Webhook 请求。 |
多语言支持语言
如果你在文本提示中使用不同于英语的语言，请在请求正文中传递值为“yes”的“multi_lingual”参数。这将在处理你的请求期间触发自动语言检测和翻译。
支持以下语言：
阿拉伯语 (ar_AR)、捷克语 (cs_CZ)、德语 (de_DE)、英语 (en_XX)、西班牙语 (es_XX)、爱沙尼亚语 (et_EE)、芬兰语 (fi_FI)、法语 (fr_XX)、古吉拉特语 (gu_IN)、印地语 (hi_IN)、意大利语 (it_IT)、日语 (ja_XX)、哈萨克语 (kk_KZ)、韩语 (ko_KR)、立陶宛语 (lt_LT)、拉脱维亚语 (lv_LV)、缅甸语 (my_MM)、尼泊尔语 (ne_NP)、荷兰语 (nl_XX)、罗马尼亚语 (ro_RO)、俄语 (ru_RU)、僧伽罗语 (si_LK)、土耳其语 (tr_TR)、越南语 (vi_VN)、中文 (zh_CN)、南非荷兰语 (af_ZA)、阿塞拜疆语 (az_AZ)、孟加拉语 (bn_IN)、波斯语 (fa_IR)、希伯来语 (he_IL)、克罗地亚语 (hr_HR)、印度尼西亚语 (id_ID)、格鲁吉亚语 (ka_GE)、高棉语 (km_KH)、马其顿语 (mk_MK)、马拉雅拉姆语 (ml_IN)、蒙古语 (mn_MN)、马拉地语 (mr_IN)、波兰语 (pl_PL)、普什图语 (ps_AF)、葡萄牙语 (pt_XX)、瑞典语 (sv_SE)、斯瓦希里语 (sw_KE)、泰米尔语 (ta_IN)、泰卢固语 (te_IN)、泰语 (th_TH)、他加禄语 (tl_XX)、乌克兰语 (uk_UA)、乌尔都语 (ur_PK)、科萨语 (xh_ZA)、加利西亚语 (gl_ES)、斯洛文尼亚语 (sl_SI)
Stable Diffusion 文生图示例
在 Apifox 中填入 API Key 后发送请求，就可以返回 JSON 响应。
找到“output”属性，“Ctrl + 鼠标左键”点击它的链接，你会看到在浏览器中打开了刚刚绘制的图像。如果你想生成其它图像，你也可以在 Apifox 中修改接口中的请求参数值。
总结
使用 Stable Diffusion API，你可以通过简单的文本提示生成惊人的图像。无论是创作艺术品还是实现创意设计，Stable Diffusion V3 API Text2Image 端点为你提供了强大的图像生成能力。通过向 https://stablediffusionapi.com/api/v3/text2img 发送 POST 请求，并携带相应参数，你即可在瞬间获得令人满意的结果，快去用起来吧！
参考链接：
- Text to Image Endpoint：https://stablediffusionapi.com/docs/stable-diffusion-api/text2img
知识拓展：