Black Forest Labs

FLUX 1.1 Pro

flux-1.1-pro

Black Forest Labs 旗舰文生图模型，相比 Flux.1 Pro 生成速度约提升 6 倍，提示词遵循度更好，适合规模化出图

flux-1.1-pro

试用 flux-1.1-pro

输入

作品灵感

查看全部作品

输出

image

填写参数并生成，结果会显示在这里。

价格

flux-1.1-pro 每张

单价	$0.050

定位简介

flux-1.1-pro 是 Black Forest Labs 面向生产环境的文生图与图生图模型，开发者通过 HiAPI.ai 统一接口调用。它支持用文字提示直接出图，也可附带参考图 URL 进行图像条件生成；提示词遵循度较好，适合需要稳定产出高质量图片的业务流程。宽高比覆盖 1:1、16:9、3:2、4:5、9:16 等常见规格，也可自定义尺寸，输出格式与质量可调，便于接入批量出图与自动化生产链路。

核心亮点

文生图与图生图双模式——同一接口既可纯提示词生成，也可传入参考图 URL 做带图条件的生成，减少多模型切换。
可复现的生成控制——支持固定 seed，重复调用可得到一致结果，便于回归测试与批量任务复现。
输出参数可按需调整——提供宽高比、自定义尺寸、webp/jpg/png 格式与输出质量选项，适配不同下游用途。
面向生产工作流设计——参数结构完整，适合接入自动化批量出图与稳定交付的业务流程。

能力说明

文本生成图像：以 prompt 为核心输入直接生成图片，适合无素材起步的创意与素材生产。

参考图条件生成：通过 image_prompt 传入 jpeg、png、gif 或 webp 参考图 URL，在已有视觉基础上做生成。

画幅与尺寸控制：内置多种常用宽高比，选择 custom 时可自定义 256 至 1440 像素的宽高并按 32 对齐。

输出格式与质量：可选 webp、jpg、png 输出，并设置 0 到 100 的输出质量，png 输出不受质量参数影响。

生成可复现与细节调节：固定 seed 复现结果，prompt_upsampling 可自动改写提示词，safety_tolerance 可调节内容放宽尺度。

适用场景

营销与广告素材批量出图——运营与市场团队输入活动文案，产出多画幅宣传图，用于投放渠道与落地页。
产品可视化场景图——电商团队以产品描述或参考图为输入，生成商品场景图，用于详情页与展示物料。
内容创作者配图生产——创作者按文章主题输入提示词，产出风格统一的配图，用于图文内容与社媒发布。
设计原型视觉呈现——设计师以概念描述或参考图为输入，快速产出视觉稿，用于方案沟通与原型方向确认。
自动化工作流出图节点——工程团队将接口接入流水线，按固定参数与 seed 稳定产出图片，用于规模化内容生产。

限制与选型建议

仅输出静态图像，不支持视频或其他模态；生成效果依赖提示词质量，复杂或具体需求需要多轮调优。宽高上限为 1440 像素，custom 尺寸会按 32 像素对齐，超大尺寸需求需另行处理。输出质量以 webp/jpg 调节为主，png 下质量参数不生效。安全容忍度调低时可能影响出图通过率。若任务需要视频生成或超出一张图范围的批量控制，应改用相应模态的模型。

常见问题

查看全部常见问题 →

FLUX1.1 [pro] 主要适合什么任务？

适合写实摄影、建筑、美食、自然和商业视觉，支持自定义尺寸与 Prompt 增强控制。
FLUX1.1 [pro] 是否支持参考图？

当前线路是纯文生图，不接收参考图。
支持哪些输出规格？

当前页面展示 Custom width / height 与 Custom、1:1、16:9、9:16；最终可选项以 Playground 参数为准。
FLUX1.1 [pro] 如何计费？

按成功生成的图片数量计费；不同分辨率或质量档如有差异，会在页面实时价格中显示。

提交生成任务

POST https://api.hiapi.ai/v1/tasks

请求头

Authorizationstring必填

账号 API Key，所有请求必填。示例：Bearer YOUR_HIAPI_API_KEY。获取 API Key

Content-Typestring可选

请求体固定按 JSON 解析；如携带，仅接受 application/json（可带 charset），其他取值返回 415。示例：application/json。

Idempotency-Keystring可选

幂等键，最长 255 字节。同账户同键的重试只创建一次任务，重放返回首次 taskId。

幂等键

网络超时或客户端自动重试时，同键只创建一次任务、不会重复扣费（幂等范围 = API Key 所属账户）。建议用业务侧唯一标识做键（如 "order-42"）；同键重放返回首次 taskId，键在首次提交 24 小时后过期。详细的场景矩阵见统一异步接口介绍页。

请求体

modelstring必填

当前固定值：flux-1.1-pro

routestring可选

当前固定值：default

inputobject必填

flux-1.1-pro 和线路 default 的业务参数对象，见下方参数表。

seedinteger可选

随机种子，用于生成可复现的结果；相同种子与其他参数一致时可复现同一次生成。

widthinteger可选min 256max 1440

自定义图像宽度，仅在 aspect_ratio 为 custom 时使用；取值会四舍五入到最接近的 32 的倍数。

heightinteger可选min 256max 1440

自定义图像高度，仅在 aspect_ratio 为 custom 时使用；取值会四舍五入到最接近的 32 的倍数。

promptstring必填

用于图像生成的文本提示词。

aspect_ratiostring可选默认值: "1:1"

生成图像的宽高比，默认 1:1。

可选项：custom1:116:93:22:34:55:49:16

显示全部（2 项）

3:44:3

image_promptstring可选

可选的参考图像 URL，格式须为 jpeg、png、gif 或 webp。

output_formatstring可选默认值: "webp"

输出图像的格式，默认 webp。

可选项：webpjpgpng

output_qualityinteger可选默认值: 80min 0max 100

保存输出图像时的质量，取值为 0 到 100 的整数，默认 80；对 png 输出无效。

safety_toleranceinteger可选默认值: 2min 1max 6

安全容忍度，取值范围为 1 到 6，1 最严格、6 最宽松，默认 2。

prompt_upsamplingboolean可选默认值: false

是否自动改写提示词以提升生成创意性，默认 false。

callbackobject可选

终态通知配置；为空则不回调，由调用方自行查询。详见下方回调说明。

回调（Webhook）

创建任务时提供 callback.url，任务终态时 HiAPI 主动 POST 通知你的服务，可免去轮询。回调请求体与任务详情数据结构同构；签名校验、投递重试与幂等说明见统一异步接口介绍页的回调说明。

urlstring必填

callback 存在时必填；任务终态后向该 URL 发起 POST，须为合法 http(s) URL。

whenstring可选默认值: "final"

当前仅支持 final，即 success / fail 均回调。

可选项：final

storagestring可选默认值: "temp"

产物存储档位：temp（默认，保留约 7 天）或 persistent（长期保存，按大小计费）。余额不足或超出存储上限会静默降级为 temp；实际生效档位见任务详情响应。

可选项：temppersistent

请求示例

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "flux-1.1-pro",
  "input": {
    "prompt": "…",
    "aspect_ratio": "1:1",
    "output_format": "webp",
    "output_quality": 80,
    "safety_tolerance": 2,
    "prompt_upsampling": false
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "flux-1.1-pro",
    input: {
      "prompt": "…",
      "aspect_ratio": "1:1",
      "output_format": "webp",
      "output_quality": 80,
      "safety_tolerance": 2,
      "prompt_upsampling": false
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "flux-1.1-pro",
        "input": {
          "prompt": "…",
          "aspect_ratio": "1:1",
          "output_format": "webp",
          "output_quality": 80,
          "safety_tolerance": 2,
          "prompt_upsampling": False
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

获取任务详情

GET https://api.hiapi.ai/v1/tasks/:id

响应字段

taskIdstring必填

任务 ID，前缀固定 tk-hiapi-。

modelstring必填

解析后的模型全名。用 route 参数提交的任务返回 base@线路（如 gpt-image-2/text-to-image@ext）；否则与创建时传入的模型名一致。

routestring可选

仅当任务用显式 route 参数提交时出现，回显提交时的原值。

statusstring必填

任务状态。

状态枚举

queued 已入队，尚未开始。 handling 处理中。 archiving 处理完成，产物准备中。 success 终态：完成，产物可用（返回 output）。 fail 终态：失败（返回 error）。提交后按 status 判断：success 或 fail 为终态，其余为非终态，建议按 1~3 秒间隔轮询直至终态。成功终态后从 output[].url 下载产物，并在 expireAt 前完成下载或转存；需要长期保留时在创建任务时使用 storage: "persistent"。

creatednumber必填

任务创建时间（Unix 秒）。

completednumber必填

进入终态的 Unix 秒；非终态固定为 0。

outputarray可选

仅 status == success 时出现。产物列表，始终为数组，同一任务可能同时返回多个 type（如 video + first_frame）。

Array [ object ]

数组元素

urlstring必填

资源 URL，可直接下载。

typestring必填

当前可能值：video、image、audio、first_frame、last_frame、thumbnail，后续可能会扩展。

expireAtnumber必填

资源可访问截止时间（Unix 秒）；过期前请完成下载或转存。

errorobject可选

仅 status == fail 时出现。

codestring必填

业务错误码。

messagestring必填

错误描述。

响应示例

成功

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

处理中（非终态）

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

失败

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}