跳转到内容
HiAPI Docs
HiAPI
在线试用 获取 API Key
中文
English 中文

FLUX.2 [klein] 4B 文生图 API

POST /v1/tasks

所有模型都通过 统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。

模型概览

模型名称 flux-2-klein-4b/text-to-image
类型 图像生成（文生图）
接口 POST /v1/tasks
价格 见 HiAPI 定价

轻量、快速且高性价比的 FLUX.2 文生图模型，支持 0.25-4 MP 分档输出，适合批量生产与多版式内容。

生产建议

生产环境建议
  • 在请求体顶层传 callback.url，任务终态后由 HiAPI 主动通知你的服务。
  • GET /v1/tasks/:id 适合本地调试或回调失败后的补偿查询。
  • 价格随 resolution 档位变化；提交前按实际输出档位估算成本。

适用场景

批量商品图与广告素材

低像素档适合大批量概念图、商品主图草稿和广告变体，便于控制单张成本。

promptresolutionaspect_ratio
社交媒体与内容配图

丰富画幅覆盖横图、竖图、方图及超宽版式，适合不同内容平台。

promptaspect_ratio
高分辨率交付

需要更大画布时可选择 2 MP 或 4 MP，适合产品细节图和后续排版。

resolutionoutput_formatoutput_quality
可复现的创意迭代

固定 seed 后可在保持构图方向的基础上持续调整提示词。

promptseed

请求参数

model string 必填

固定填 flux-2-klein-4b/text-to-image。

示例 flux-2-klein-4b/text-to-image
input object 必填

业务参数对象；FLUX.2 [klein] 4B 的模型专属配置都放在这里。

prompt string 必填

用于生成图片的文字提示词。

resolution enum 可选

输出像素档位；按 0.25、0.5、1、2、4 MP 分档计费。

默认 1 MP 可选值: 0.25 MP0.5 MP1 MP2 MP4 MP
aspect_ratio enum 可选

生成图片的宽高比，支持常用横图、竖图和超宽画幅。

默认 1:1 可选值: 1:116:99:163:22:34:33:45:44:521:99:21
seed integer 可选

用于复现结果的随机种子。

output_format enum 可选

生成图片的文件格式。

默认 jpg 可选值: webpjpgpng
output_quality integer 可选

jpg 和 webp 的压缩质量，范围 0-100；png 不受此参数影响。

默认 95
callback object 可选

可选回调配置；设置后任务进入终态时 HiAPI 会主动通知你的服务。

url string 必填

传入 callback 时必填；接收任务终态通知的 HTTPS 地址。

示例 https://your-domain.com/hiapi/callback
when enum 可选

回调触发时机；当前固定为 final。

默认 final 可选值: final

用例示例

高端香水商业摄影

1 MP 方图用于快速验证材质、轮廓光与玻璃折射。

请求体
{
  "model": "flux-2-klein-4b/text-to-image",
  "input": {
    "prompt": "A translucent amber perfume bottle on dark volcanic stone, dramatic studio rim lighting, premium commercial photography, realistic glass refraction",
    "resolution": "1 MP",
    "aspect_ratio": "1:1",
    "output_format": "jpg",
    "output_quality": 95
  }
}
2 MP 未来摩托车广告

16:9 与 2 MP 组合适合横版广告和网站头图。

请求体
{
  "model": "flux-2-klein-4b/text-to-image",
  "input": {
    "prompt": "A futuristic electric motorcycle displayed in a brutalist concrete gallery, wet reflective floor, dramatic cyan and amber rim lighting",
    "resolution": "2 MP",
    "aspect_ratio": "16:9",
    "seed": 84,
    "output_format": "png"
  }
}

获取结果

  1. 提交成功后立即返回 taskId（不等待生成完成）。
  2. 生产环境优先等待 callback.url 收到终态通知；本地调试时可轮询 GET /v1/tasks/:id。
  3. status=success 后，从返回的 output[].url 下载生成的图片。
  4. 如果 status=fail，按返回的错误信息修正请求，不要盲目重试同一个无效请求。

常见问题

什么是 FLUX.2 [klein] 4B API？

它是面向快速、低成本图像生成的轻量级 FLUX.2 文生图模型。HiAPI 当前提供 text-to-image 接口，适合批量草稿、商品概念图和多版式内容生成。

FLUX.2 [klein] 4B 在 HiAPI 如何计费？

按输出分辨率档位计费，0.25 MP 到 4 MP 的价格不同，请以实时价格页为准。 查看实时价格

FLUX.2 [klein] 4B 支持哪些分辨率和画幅？

支持 0.25、0.5、1、2、4 MP 五个分辨率档位，以及方图、横图、竖图和超宽画幅。完整可选值请查看上方请求参数。

FLUX.2 [klein] 4B 和 9B 应该怎么选？

4B 更强调生成速度和成本控制；9B 更侧重速度与画面质量的平衡。HiAPI dev 实测中，9B 在复杂场景和英文画面文字上表现更稳，但重要文字仍需人工复核。 查看 9B API 文档

FLUX.2 [klein] 4B 支持图像编辑吗？

当前页面提供的是文生图接口，仅接收文字提示词，不包含参考图或图像编辑参数。需要修改已有图片时，请选择专门的图生图模型。

下一步