Flux API
图像接口按 Flux 3、Flux 2、Flux 1 分组。新接入用 FLUX 3 Image：一个POST /bfl/v1/flux-3-image 同时负责文生图和改图。要锁定种子、精确宽高或采样步数时，改用 FLUX 3 Image Klein。
请求发到 https://api.ttapi.io，Header 带 TT-API-KEY。Key 在 控制台 创建，见 网关与鉴权。
提交后立刻返回的是 jobId，图片在任务完成之后才有。用 查询接口 轮询，或在请求里带 webhook_url 接收回调。FLUX 3 Image 和 Klein 都按分辨率计费，当前是官方价格 6 折，见 图片计费。
文生图和改图是同一次请求
不传images，模型按 prompt 出一张新图。传入 images 后，同一条提示词变成编辑指令：改细节、换风格，或把几张图合成一张。
改图时把要动的地方写具体。「把图 1 中间那只鸟改成 #e01075，其余保持不变」比「让它更好看」稳。多张图按数组顺序叫图 1、图 2，提示词里也按这个顺序指代。
images 接受一张图片的 URL 或 base64，也可以是数组，一共 1 到 10 张。单张不能小于 256×256，也不能超过 16 百万像素。FLUX 3 Image 不认 input_image、seed、width、height，这些字段会直接报错。
Klein 的参考图规则多一条：第一张是被编辑的原图，省略宽高时输出尺寸也跟着它走。
用边界框指定位置
元素要放在画面的固定区域，或者只改画面的一块时，把边界框写在提示词末尾。坐标是 0 到 1000 的网格，顺序为[top, left, bottom, right]。左上角是 [0, 0]，右下角是 [1000, 1000]。
提示词里用尖括号标出对象，再在末尾给出对应的框和说明：
id 和提示词里的尖括号对应，desc 写这个区域要变成什么。完整字段见 FLUX 3 Image。
先定画幅，再定清晰度
aspect_ratio 默认 auto。文生图时建议自己传，例如 16:9、1:1、9:16、21:9。auto 会先看提示词里有没有比例；没有参考图、提示词也没写比例时，FLUX 3 Image 用 1:1，Klein 用 16:9。有参考图时，auto 保持第一张图的画幅。
resolution 是像素面积档，默认 1k：
换一档分辨率会重新生成，构图可能和低档草稿不一样。具体边长随宽高比变化。Klein 如果同时传了
width 和 height，上面两个字段都会被盖掉。
grounding 默认开启。模型可以检索网页和图片来核对提示词里的实物；关掉之后只按提示词画，通常更快。
什么时候用 Klein
FLUX 3 Image Klein 和 FLUX 3 Image 做同一类事：文生图、最多 10 张参考图、边界框。它额外能控制这些：width和height一起传，范围各是 64 到 6256，乘积不超过 16822272seed用来复现同一次生成，范围 0 到 4294967295output_format选jpeg或png，默认jpegsteps是采样步数，1 到 16，默认 16
一次完整调用
PENDING_QUEUE 是还在排队，ON_QUEUE 是正在生成。SUCCESS 之后读 data.imageUrl。地址有有效期，见 存储与持久化。FAILED 时看 message。状态码说明见 状态码与返回值。
调试时轮询即可，间隔几秒查一次。服务端已经有公网地址时，提交请求加上 webhook_url，完成后结果会推过去。