生成图片
DeerAPI FLUX 生成图片接口：通过 POST /flux/v1/ 统一调用 BFL 风格异步生图与编辑能力，支持 FLUX 1.1、FLUX 2、Kontext、Expand、Fill 等当前已接入的 DeerAPI 短模型 ID，并可用 /flux/v1/get_result 查询结果。
curl https://api.deerapi.com/flux/v1/flux-pro-1.1 \
-H "Authorization: Bearer <DEERAPI_KEY>" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A red paper lantern on a wooden table, studio photo",
"width": 1024,
"height": 1024,
"output_format": "jpeg"
}'{
"id": "a738c474-3d9e-421a-860d-c7825c547fbb",
"polling_url": "https://api.eu2.bfl.ai/v1/get_result?id=a738c474-3d9e-421a-860d-c7825c547fbb",
"cost": null,
"input_mp": null,
"output_mp": null
}id，不是最终图片。最稳的首个调用流程
创建后立即保存 id
id 后，继续去 统一查询任务。这条短路径和官方 BFL 的关系
- BFL 官方为每个模型提供独立路径；DeerAPI 把它们统一收敛到
POST /flux/v1/{model}。 - 官方鉴权使用
x-key和 BFL 域名；DeerAPI 统一改成https://api.deerapi.com+ Bearer Token。 - 官方通常让你直接轮询
polling_url；DeerAPI 额外提供了统一查询页，方便把 BFL 和 Replicate 风格任务放进同一套代码里处理。
常见参数什么时候才需要
width/height：标准文生图最常用。aspect_ratio：Kontext 和一部分新版模型更常用。input_image：只有编辑类或参考图类模型才需要。mask：主要用于flux-pro-1.0-fill这种局部重绘。control_image：用于canny、depth这类控制模型。raw：只对部分支持 Raw 风格输出的模型有意义。
参考文档
- BFL Quick Start: Image Generation with Text Prompts
- BFL FLUX1.1 Pro
- BFL FLUX1.1 Pro Ultra / Raw
- BFL FLUX.1 Kontext
- BFL FLUX.2 Overview
Authorizations
使用 DeerAPI Key 进行 Bearer Token 鉴权。
Path Parameters
DeerAPI 当前支持的 FLUX 短模型 ID。
flux-pro-1.1, flux-pro-1.1-ultra, flux-pro, flux-dev, flux-kontext-pro, flux-kontext-max, flux-2-pro, flux-2-flex, flux-2-max, flux-pro-1.0-fill, flux-pro-1.0-canny, flux-pro-1.0-depth, flux-pro-1.0-expand Body
文本提示词。绝大多数 FLUX 模型都需要。
输出宽度。常用于 flux-pro-1.1、flux-pro、flux-dev 这类标准文生图模型。
输出高度。常用于 flux-pro-1.1、flux-pro、flux-dev 这类标准文生图模型。
输出宽高比。Kontext、FLUX.2 及部分新模型更常使用该字段，例如 1:1、16:9、match_input_image。
参考图或待编辑图片 URL。常用于 Kontext 类模型。
多参考图输入。更适合 FLUX.2 等支持多参考图的模型。
Base64 编码的输入图。常用于 flux-pro-1.0-fill 或 flux-pro-1.0-expand。
Base64 编码的遮罩图。白色区域表示需要重绘，黑色区域表示保留。主要用于 flux-pro-1.0-fill。
控制图 URL 或 Base64 数据。主要用于 flux-pro-1.0-canny、flux-pro-1.0-depth。
Base64 编码的视觉参考图。常用于 flux-pro-1.1-ultra。
视觉参考图对结果的影响强度。
0 <= x <= 1推理步数。更多见于 Fill / 控制类模型。
提示词引导强度。更多见于 Fill / 控制类模型。
是否让模型自动优化提示词。
随机种子。固定种子有助于提升可复现性。
安全阈值，数字越大限制越宽松。
0 <= x <= 6输出图片格式。
jpeg, png 是否启用更自然、偏纪实的 Raw 风格输出。主要用于 flux-pro-1.1-ultra。
异步完成回调地址。
回调签名校验密钥。
curl https://api.deerapi.com/flux/v1/flux-pro-1.1 \
-H "Authorization: Bearer <DEERAPI_KEY>" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A red paper lantern on a wooden table, studio photo",
"width": 1024,
"height": 1024,
"output_format": "jpeg"
}'{
"id": "a738c474-3d9e-421a-860d-c7825c547fbb",
"polling_url": "https://api.eu2.bfl.ai/v1/get_result?id=a738c474-3d9e-421a-860d-c7825c547fbb",
"cost": null,
"input_mp": null,
"output_mp": null
}