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

POST /v1/tasks

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

模型概览

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

默认四步快速生成的 FLUX.2 文生图模型，兼顾速度与画面质量，适合商业视觉、复杂场景和英文标题海报。

生产建议

生产环境建议

在请求体顶层传 callback.url，任务终态后由 HiAPI 主动通知你的服务。
GET /v1/tasks/:id 适合本地调试或回调失败后的补偿查询。
默认四步适合大多数请求；重要文字交付仍需检查拼写和版式。

适用场景

带文字的海报与封面

HiAPI dev 实测可生成清晰英文标题，适合杂志封面、活动海报和品牌标题图；重要文字仍需人工复核。

promptaspect_ratio

写实商业视觉

适合强调光影、材质和空间细节的产品广告与编辑摄影。

promptnum_inference_steps

快速高质量草案

默认四步生成，在速度和细节之间取得平衡，便于快速筛选创意方向。

promptnum_inference_steps

稳定构图迭代

固定 seed 后可以在相同创意方向上调整标题、配色和环境细节。

promptseed

请求参数

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

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
# 把 YOUR_API_KEY 换成你的账号 API Key
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "flux-2-klein-9b/text-to-image",
  "input": {
    "prompt": "A premium editorial poster for a fictional lunar hotel, crisp readable title '\''LUNAR NOIR'\'', cinematic moonlit architecture",
    "aspect_ratio": "4:3",
    "num_inference_steps": 4,
    "output_format": "png"
  }
}'

import requests, json

# 业务参数对象，字段随模型而定（见对应模型页）
payload = json.loads(r'''
{
  "model": "flux-2-klein-9b/text-to-image",
  "input": {
    "prompt": "A premium editorial poster for a fictional lunar hotel, crisp readable title 'LUNAR NOIR', cinematic moonlit architecture",
    "aspect_ratio": "4:3",
    "num_inference_steps": 4,
    "output_format": "png"
  }
}
''')

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
resp = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"},
    json=payload,
)
print(resp.json())  # 成功返回 { code, message, data: { taskId } }

// 提交异步任务，成功立即返回 taskId（不等待生成完成）
// 把 YOUR_API_KEY 换成你的账号 API Key
const resp = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "flux-2-klein-9b/text-to-image",
  "input": {
    "prompt": "A premium editorial poster for a fictional lunar hotel, crisp readable title 'LUNAR NOIR', cinematic moonlit architecture",
    "aspect_ratio": "4:3",
    "num_inference_steps": 4,
    "output_format": "png"
  }
}),
});
console.log(await resp.json()); // 成功返回 { code, message, data: { taskId } }

model string 必填

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

示例 flux-2-klein-9b/text-to-image

input object 必填

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

prompt string 必填

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

aspect_ratio enum 可选

生成图片的宽高比；支持方图、横图和竖图预设。

默认 4:3 可选值: 1:14:33:416:99:16

seed integer 可选

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

num_inference_steps integer 可选

推理步数；必须是 4 到 8 的整数，默认值为 4。

默认 4

output_format enum 可选

生成图片的文件格式。

默认 png 可选值: jpegpngwebp

callback object 可选

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

url string 必填

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

示例 https://your-domain.com/hiapi/callback

when enum 可选

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

默认 final 可选值: final

用例示例

月球酒店编辑海报

4:3 海报测试画面文字、月光建筑与编辑设计感。

请求体

{
  "model": "flux-2-klein-9b/text-to-image",
  "input": {
    "prompt": "A premium editorial poster for a fictional lunar hotel, crisp readable title 'LUNAR NOIR', cinematic moonlit architecture",
    "aspect_ratio": "4:3",
    "num_inference_steps": 4,
    "output_format": "png"
  }
}

16:9 温室夜市

宽画幅用于复杂场景、发光灯笼和可读招牌。

请求体

{
  "model": "flux-2-klein-9b/text-to-image",
  "input": {
    "prompt": "A cinematic night market built inside a glass greenhouse, luminous paper lanterns, crisp readable sign 'NIGHT BLOOM', premium editorial photography",
    "aspect_ratio": "16:9",
    "seed": 42,
    "num_inference_steps": 4,
    "output_format": "webp"
  }
}

获取结果

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

常见问题

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

它是兼顾生成速度和画面质量的 FLUX.2 文生图模型。HiAPI 当前提供 text-to-image 接口，适合快速创意草案、商业视觉和包含英文标题的海报。

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

当前支持的比例预设按张计费，请以实时价格页为准。查看实时价格

FLUX.2 [klein] 9B 为什么适合快速生成？

模型默认使用四步推理，适合快速原型和高频内容生产。实际生成时间仍会受到请求队列、画面复杂度和网络状况影响。

FLUX.2 [klein] 9B 适合生成海报文字吗？

HiAPI dev 实测可生成清晰的英文标题，但这不代表所有文字都能稳定还原。复杂排版仍应检查拼写，并为重要交付预留重试和人工复核。

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

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