调用FLUX模型需确认平台支持、配置正确API密钥、使用指定端点和参数：一、在模型市场启用black-forest-labs/flux-schnell；二、创建含images:generate权限的API Key；三、POST至/v1/images/generations，JSON中必填model、prompt、size；四、60分钟内下载响应中的临时图片URL；五、依error.message排查拼写、长度或分辨率问题。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试在SiliconFlow平台上调用FLUX模型但未成功，可能是由于模型名称拼写错误、API端点不匹配或请求参数缺失所致。以下是调用FLUX模型的具体操作步骤：
一、确认FLUX模型在SiliconFlow平台的可用性
FLUX并非SiliconFlow官方文档中列明的原生支持模型（如deepseek-v1.5b、flux-dev、flux-schnell等属于Black Forest Labs开源模型，需通过兼容接口或特定路由调用）。SiliconFlow平台当前公开支持的图像生成类模型中，仅部分版本的FLUX模型可通过/v1/images/generations端点调用，且必须使用model参数显式指定为"black-forest-labs/flux-schnell"或"black-forest-labs/flux-dev"。调用前须登录控制台，在「模型市场」中搜索“FLUX”并确认其状态为“已启用”。
1、访问 https://cloud.siliconflow.cn/models 并登录账号。
2、在搜索框输入 flux，查看返回列表中模型名称、状态及支持能力标签。
3、若列表中无FLUX相关条目，则说明该模型未对您的账户开放，需提交模型开通申请。
二、配置API密钥与认证头
所有FLUX模型调用均需通过Bearer Token方式认证，密钥必须为具备图像生成权限的API Key。该密钥不可复用于文本模型接口，且需确保所属项目已绑定FLUX模型调用配额。
1、进入「API管理」→「密钥管理」页面，点击「新建密钥」。
2、在权限设置中勾选 images:generate 和 models:use 两项。
3、复制生成的密钥字符串，保存至安全位置；该密钥仅显示一次，关闭页面后不可再次查看。
4、构造HTTP请求头：Authorization字段值为 Bearer sk-xxx（sk-开头，长度为52字符）。
三、发送FLUX图像生成请求
FLUX模型仅支持图像生成（text-to-image）任务，不支持聊天、语音或视频接口。请求必须使用POST方法，目标URL为 https://api.siliconflow.cn/v1/images/generations，且Content-Type必须为application/json。
1、准备JSON载荷，确保包含以下必填字段：model（设为"black-forest-labs/flux-schnell"）、prompt（非空UTF-8字符串）、size（支持"1024x1024"、"768x1344"、"1344x768"三种）。
2、可选添加 num_images（默认1，最大4）、seed（整数，用于结果复现）、guidance_scale（3.0–20.0，默认7.0）。
3、使用curl命令测试（替换YOUR_API_KEY和PROMPT_TEXT）：
curl -X POST "https://api.siliconflow.cn/v1/images/generations" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"black-forest-labs/flux-schnell","prompt":"Pirate ship in stormy sea, cinematic lighting","size":"1024x1024"}'
四、处理响应与下载图片
成功调用后，API返回JSON对象，其中data字段为数组，每个元素含url字段。该URL为临时直链，有效期严格为60分钟，超时后返回404错误。用户必须主动发起HTTP GET请求下载二进制图片数据并持久化存储。
1、解析响应JSON，提取首个元素的url值，例如 https://cdn.siliconflow.cn/xxx.png?Expires=1739XXXXXX。
2、使用wget或Python requests库发起GET请求，禁止直接在浏览器地址栏打开该链接进行人工下载（可能触发防盗链拦截）。
3、将响应体以二进制模式写入本地文件，扩展名须与Content-Type头中声明的类型一致（通常为.png或.jpeg）。
五、常见报错与对应修正
当返回非200状态码时，需依据error.message字段内容快速定位问题。SiliconFlow对FLUX模型的错误响应结构统一，message值具有明确语义，无需依赖HTTP状态码做主判断。
1、若返回 "Model not found or not authorized"：检查model参数是否拼写为"black-forest-labs/flux-schnell"（注意大小写与连字符），并确认API密钥已绑定FLUX模型权限。
2、若返回 "Invalid prompt length"：prompt字段长度超出1024字符限制，需截断或重写提示词。
3、若返回 "Size not supported for this model"：当前FLUX版本不支持所选分辨率，改用"1024x1024"重新提交。
