FLUX 3 Image Klein

快速示例

提交一次图像请求，保存返回的 id，并轮询直到任务为 completed 或 failed。此 API 使用异步任务，以 URL 返回输出。

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"flux-3-image-klein","prompt":"An amber bottle on pale limestone in soft morning light","resolution":"1k","aspect_ratio":"3:2"}'

端点与请求头

POST https://api.seedrouter.ai/v1/images/generations

请将密钥保存在服务端。HTTP 成功仅表示任务已受理，并不表示图像已就绪。

参数

接受 11 个字段，只有 model 和 prompt 必填。省略可选字段即可使用默认值；不接受 null。

比例：auto、21:9、2:1、16:9、3:2、7:5、4:3、5:4、1:1、4:5、3:4、5:7、2:3、9:16、1:2、9:21。

Playground 固定模型，提供十个输入控件，包括固定为 1 的 n。大于 2 的安全值仅限 API，管理员除外。

模式与约束

无参考图时为文生图。一张参考图用于编辑，多张参考图用于融合构图。使用 auto 时，编辑沿用第一张参考图的宽高比。纯文字生成根据提示词选择画幅，无法确定时使用 1:1。所有模式的分辨率默认均为 1k。

分辨率档位表示图像的大致规模：768sq 约为 768 × 768；1K 约为 1 MP；1.5K 约为 2 MP；2K 约为 4 MP；4K 约为 16 MP。实际尺寸请检查返回文件。

此端点不接受 width、height、size 中的像素尺寸、negative_prompt、guidance、grounding、prompt_upsampling、mask 或 mask_url。未知字段会在计费前返回 HTTP 400。不提供 WebP 输出、base64 输入、流式传输或回调。

参考图与区域编辑

提交前，将参考图上传至公开 URL。请求体包含 URL，不包含文件字节或 data URL。

{
  "model": "flux-3-image-klein",
  "prompt": "Use Image 1 as the subject and Image 2 as the setting; match the perspective and light",
  "image_urls": ["https://example.com/subject.png", "https://example.com/setting.png"],
  "aspect_ratio": "auto",
  "resolution": "2k",
  "seed": 0,
  "steps": 16,
  "output_format": "png"
}

将占位 URL 替换为你自己可访问的图像。参考图按顺序排列：ref_image_0 为第一张。边界框指令属于 prompt 字符串，不是单独的请求字段。坐标使用 [y1, x1, y2, x2]，归一化到 0–1000。布局对象可包含 id、bbox 和 desc；编辑可使用 id、from、src_bbox、tgt_bbox 和 desc。请对完整请求进行 JSON 编码，正确转义提示词中的引号。

计费

一次成功请求生成一张图像。价格仅由所选分辨率决定；步数、种子、宽高比、参考图数量和格式均不额外收费。文生图与编辑费率相同。失败的请求不收费。参见实时价格。

任务响应与轮询

提交响应：

{"id":"task_example","model":"flux-3-image-klein","status":"processing"}

curl https://api.seedrouter.ai/v1/tasks/task_example \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

已完成任务（URL 仅作示例）：

{
  "id": "task_example",
  "model": "flux-3-image-klein",
  "status": "completed",
  "output": {"data": [{"url": "https://file.deepytb.com/generated/example.png"}]}
}

读取 output.data[0].url。请为生成预留最多十分钟，尤其是 4K。轮询为只读操作；客户端超时不意味着可以再次提交付费请求。公开任务响应不包含费用或账户余额。

错误

HTTP 错误使用 {"error": {"code": integer, "message": string}}。参见公共错误目录。失败任务会在 status: "failed" 旁提供错误信息。重新提交前先修正无效参数；查询已提交请求时保留任务 ID。

提示与相关指南

使用正面描述，明确需要保留的区域或细节。降低步数可能改变质量，但不会降低价格。每次只改变一个因素进行比较。

• FLUX 3 Image Klein Playground
• 下载、权重与 ComfyUI 指南
• 任务生命周期