硅基流动怎么调用SD模型？文生图API使用教程

生成Stable Diffusion系列图片时，必须通过硅基流动最新API发起调用，并严格填写正确的模型名称（如sd-turbo）、英文提示词以及与接口要求对应的image_size，同时在Header中携带Bearer认证密钥；接口返回的图片URL为10分钟内有效的临时直链，使用前还需检查HTTP状态码，确认链接确已可用。

要在硅基流动上调用Stable Diffusion系列模型（如stable-diffusion-xl-base-1.0、sd-turbo、sdxl-turbo等）生成图片，必须通过其最新API接口发起HTTP请求，网页端点击生成的图片不走API通道，无法复现或批量调用。

获取可用SD模型列表

打开硅基流动API文档页 https://docs.siliconflow.cn/api-reference/images/images-generations → 向下滚动至「Model」参数说明区域 → 查看支持的全部文生图模型名称。其中SD系模型包括：

、、、、。注意：stable-diffusion-3-medium虽带“3”字，但并非SDXL分支，它对提示词理解更严格，首次调用建议先用sd-turbo验证流程。

模型名区分大小写，拼错一个字母就会返回404错误，比如写成“SD-Turbo”或“sdxl_turbo”均无效。

准备API密钥与请求头

登录硅基流动控制台 → 进入「账户设置 → API密钥」页面 → 点击「创建新密钥」→ 复制生成的密钥字符串（以sk-开头，共52位）。该密钥需在每次请求的Header中以Bearer方式传递。

构造请求Header时，必须包含两项：Authorization: Bearer sk-xxx 和 Content-Type: application/json。漏掉任意一项，服务器会直接拒绝并返回401或400错误，不会进入模型调度环节。

构造标准API请求体

使用curl或Postman发送POST请求到 https://api.siliconflow.cn/v1/images/generations，Body为JSON格式，至少包含三个字段：

①

：填入上一步确认的SD模型名，例如 "sd-turbo"；

②

：英文描述，长度建议控制在150词以内，中文提示词会被静默过滤或导致生成异常；

③

：必须从预设值中选择，SDXL类模型仅支持 "1024x1024" 或 "768x768"，sd-turbo则只认 "512x512"——填错尺寸会触发422校验失败，且错误信息不提示具体哪项出错。

完整示例（sd-turbo）：

{ "model": "sd-turbo", "prompt": "a cyberpunk cat wearing neon goggles, cinematic lighting, ultra detailed", "image_size": "512x512" }

解析响应并提取图片URL

请求成功后返回JSON，结构固定包含 data 数组 → 每个元素含 url 字段 → 该URL是临时直链，10分钟内有效，过期即失效，不可缓存复用。

若返回 "data": [] 或 url 字段为空，说明模型正在排队或资源不足，此时应等待3秒后重试，不要立即换模型——同一账号高频切换模型可能触发限流。

这一步不能跳过验证：拿到URL后务必用浏览器或curl -I 检查HTTP状态码是否为200，有些情况下API返回200但body里是HTML错误页（比如token耗尽），实际图片并未生成。

Python快速调用示例

方法一：requests库三行代码启动

安装依赖：pip install requests；

执行以下脚本（替换YOUR_API_KEY和prompt内容）：

import requests
response = requests.post("https://api.siliconflow.cn/v1/images/generations",
    headers={"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"},
    json={"model": "sdxl-turbo", "prompt": "a golden retriever puppy on a sunlit grass field, shallow depth of field", "image_size": "1024x1024"})
print(response.json()["data"][0]["url"])

方法二：用硅基流动最新SDK（推荐用于生产环境）

运行 pip install siliconflow → 初始化客户端时传入API密钥 → 调用 client.images.generations.create() 方法，自动处理重试、超时、鉴权刷新等边界情况。