使用指南
通过 hiapi API 使用 flux-2-klein-9b/text-to-image 生成电商产品图
大多数又快又便宜的文生图模型都会逼你做选择：要么图上文字清晰可读，要么价格低廉。flux-2-klein-9b/text-to-image 是「低价快速」档位中少数不强迫你二选一的模型之一。hiapi 给它打的标签是 Text Rendering, High Fidelity（文字渲染、高保真）——而在实际使用中，这意味着它能在同一次生成里渲染出品牌文字标识、一行小字标签和醒目的促销大标题，无需再跑第二遍去修正乱码字母。
这一点对电商产品图尤其重要：真正需要文字的那些图——带可见标签的主图、带价格标注的限时促销横幅——恰恰是廉价「快速」模型最容易搞砸的。
本文将全部三张图都用 flux-2-klein-9b/text-to-image 生成，零重试：标签文字、促销大标题和折扣信息行在首次生成时就全部干净无误。这并不是说每个提示词都能保证如此（见下方的校对提示），但对这个价位的模型来说，这是个好兆头。
定价：flux-2-klein-9b 与 flux-2-klein-4b（文生图）对比
两个模型同属「Klein」家族，都主打快速、低成本。区别在于你花钱买的是什么：
| 模型 | 每张图片价格 | 标签 |
|---|---|---|
flux-2-klein-9b/text-to-image |
统一 $0.00858 | Text-to-Image, Text Rendering, High Fidelity |
flux-2-klein-4b/text-to-image |
统一 $0.00143 | Text-to-Image, Fast, Cost Efficient |
（价格为 2026-08 数据，已对照 /api/pricing 确认。）
flux-2-klein-4b/text-to-image 大约便宜 6 倍——适合作为背景板、生活场景图，或任何文字不参与构图的图片的默认选择。但它并没有文字渲染标签，所以如果卡片、标签或横幅上的文字要真正清晰可读，即便价格更高，klein-9b 也是更稳妥的选择。而每张不到一美分的价格，这里的「稳妥」仍然比大多数 LLM 的一次 API 调用还便宜。
一次真实请求
下面是针对 /v1/tasks 端点、生成一张带渲染文字的促销卡片的可用请求：
curl -s -X POST https://api.hiapi.ai/v1/tasks \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-2-klein-9b/text-to-image",
"input": {
"prompt": "电商限时促销的社交媒体宣传横幅：一只磨砂玻璃滴管瓶，标签上写着 'VELURA HYDRA SERUM'，居中置于从腮红粉过渡到奶油色的柔和渐变背景上，顶部是粗体整洁的无衬线大标题文字，内容为 'FLASH SALE'，深炭灰色字母，下方一行较小的文字，内容为 '30% OFF'，使用相同字体，右下角有一个细线圆角矩形徽标，内含文字 'VELURA'，排版清晰可读，留白均衡，现代极简营销设计，无其他文字，无水印",
"aspect_ratio": "1:1"
}
}'
该请求返回一个 taskId。轮询 GET /v1/tasks/{taskId} 直到 status 为 success，然后下载 output[0].url——签名链接会过期，所以要立即拉取字节并自行存储。
Schema 注意事项：实际可用的部分
在基于该模型开发之前，有几点值得了解，这些基于 API 实际接受的内容（而不仅仅是文档）：
resolution会被拒绝。与其他一些 hiapi 图像模型不同，发送resolution字段会返回 400（additional properties not allowed）。只发送aspect_ratio。aspect_ratio是一个固定的短列表：1:1、4:3、3:4、16:9、9:16。没有4:5或21:9——如果你的版式想要更高的竖版裁剪，3:4是最接近的支持比例（下文的生活场景图我们用的就是这个）。aspect_ratio本身是可选的。完全省略它仍会生成有效图片，使用服务端默认值——但在电商工作中你几乎总是想要一个确定的画幅（信息流帖子用方形，主横幅用 16:9），因此值得显式设置，而不是依赖默认值。- 按图统一定价，无分辨率分档。与
flux-2-klein-4b/image-to-image（按兆像素分五档价格）不同，klein-9b/text-to-image 无论宽高比如何都是单一统一费率。
提示词 + 输出：主图
提示词（16:9，原样使用，生成后未做修改）：
电商产品主图：一只装满高端护肤精华的磨砂玻璃滴管瓶立于湿润的灰色大理石板之上，左侧柔和的日光投下轻柔的倒影，极简米色背景，大理石上有细小水珠，瓶身上的标签清晰地写着 'VELURA'，采用干净的现代衬线字体，下方是较小的文字 'HYDRA SERUM'，专业影棚产品摄影，焦点锐利，微妙的轮廓光，无其他文字，无手部，无 logo 水印
（图为本文顶部所示。）品牌名和产品线在正常阅读距离下都渲染干净——没有重复字母，没有融化的衬线，而这正是这个价位的低价文生图模型常见的失败模式。
提示词 + 输出：生活场景
提示词（3:4）：
生活化电商照片：一只标签上写着 'VELURA HYDRA SERUM' 的磨砂玻璃滴管瓶，放在明亮的浴室台面上，旁边是一条折叠的白毛巾和一小枝盆栽尤加利，温暖的晨光透过窗户洒入，柔和的阴影，浅景深，自然随性的造型，瓶身标签文字 'VELURA' 和 'HYDRA SERUM' 保持锐利清晰可读，无人物，无手部，无额外文字叠加
像这样的生活场景图通常根本不需要图上文字——但标签仍然要在比影棚主图更柔和、更漫射的光照条件下经得住考验，而这对模型的文字保真度是更难的测试。
提示词 + 输出：限时促销卡片
提示词（1:1）：
电商限时促销的社交媒体宣传横幅：一只标签上写着 'VELURA HYDRA SERUM' 的磨砂玻璃滴管瓶，居中置于从腮红粉过渡到奶油色的柔和渐变背景上，顶部是粗体整洁的无衬线大标题文字，内容为 'FLASH SALE'，深炭灰色字母，下方一行较小的文字，内容为 '30% OFF'，使用相同字体，右下角有一个细线圆角矩形徽标，内含文字 'VELURA'，排版清晰可读，留白均衡，现代极简营销设计，无其他文字，无水印
这才是真正考验模型「Text Rendering, High Fidelity」标签的那张图：两行大标题文字加一个小徽标文字，全部在一次生成中完成。每个词都拼写正确，字距也保持得当——但正因为如此，发布前你仍应亲自过目检查（见下文）。
别跳过校对
hiapi 自家的内容指南对此说得很直白：AI 文字渲染是「99%，而非 100%」。即便是打了高保真文字标签的模型，偶尔也会拼错一个词、漏掉一个字母或把两个词挤在一起——小标签文字比大标题文字尤其如此（小字更难）。在发布生成的促销卡片或产品标签之前：
- 以 100% 比例放大查看每一行渲染文字。
- 检查拼写和间距，而不仅仅是「看起来像文字」。
- 如果有什么不对，重新生成——不要手动修改像素，因为重跑一次只要几分钱的一小部分。
- 对于经常变动的文字（价格、促销日期），考虑在你自己的模板步骤中叠加，而不是把它烘焙进每一次生成——更新更便宜，也完全消除了重跑的风险。
用 Python 批量生成
对于完整的产品目录，把同样的请求模式包进一个循环：
import requests
import time
API_KEY = "your-api-key"
BASE = "https://api.hiapi.ai/v1/tasks"
def generate(prompt, aspect_ratio="1:1"):
resp = requests.post(
BASE,
headers={"Authorization": f"Bearer {API_KEY}"},
json={
"model": "flux-2-klein-9b/text-to-image",
"input": {"prompt": prompt, "aspect_ratio": aspect_ratio},
},
)
task_id = resp.json()["data"]["taskId"]
while True:
task = requests.get(
f"{BASE}/{task_id}",
headers={"Authorization": f"Bearer {API_KEY}"},
).json()["data"]
if task["status"] == "success":
return task["output"][0]["url"]
if task["status"] == "fail":
raise RuntimeError(task["error"])
time.sleep(5)
prompts = [
("Hero shot for product SKU-001, studio lighting, label reads 'BRAND NAME'", "16:9"),
("Lifestyle shot for product SKU-001 on a wooden shelf", "3:4"),
("Flash sale card for product SKU-001, headline 'LIMITED TIME'", "1:1"),
]
for prompt, ratio in prompts:
url = generate(prompt, ratio)
print(url) # download immediately — the URL expires
按每张图 $0.00858 计算，一个 50 个 SKU、每个 SKU 3 张图（主图、生活场景、促销图）的产品目录总共约 $1.29——相比一次自由职业产品摄影拍摄，这基本就是个零头。
flux-2-klein-9b/text-to-image 与相关工作流对比
如果你正在 hiapi 上搭建更完整的产品图流水线，接下来值得阅读几个相关部分：
- 如果你需要编辑或换风格处理现有产品照片，而不是从零生成，请参见 flux-2-klein-4b 用于图生图电商修图——这是一项不同的任务（i2i，而非 t2i），专为修整真实照片而非生成新场景而构建。
- 关于 9b 档位图生图模式特有的提示词模式（同样的文字渲染强度，应用于编辑），请参见 flux-2-klein-9b 图生图提示词。
- 完整参数、实时定价，以及可在批量运行前测试提示词的操作台：flux-2-klein-9b/text-to-image 模型页面。
FAQ
flux-2-klein-9b/text-to-image 支持图生图吗？
不支持——这个特定端点仅支持文生图。hiapi 另列了一个 flux-2-klein-9b/image-to-image 模型（定价 $0.03143/图）用于编辑现有照片。
支持哪些宽高比？
五种：1:1、4:3、3:4、16:9、9:16。没有原生 4:5——用 3:4 获得类似的竖版裁剪。
我可以设置输出分辨率吗？
不能。发送 resolution 字段会返回 400。定价和输出尺寸按宽高比固定。
改用 flux-2-klein-4b 会更便宜吗？ 是的，每张图大约便宜 6 倍（$0.00143 对 $0.00858）——但 klein-4b 没有文字渲染标签。把它用于无文字图片（纯生活场景或背景图），把 klein-9b 留给任何带标签、标题或价格标注的图片。
生成需要多长时间？
本文中的全部三张图通过 /v1/tasks 轮询流程，每张都在两分钟以内完成。
试一试
你可以直接在模型页面上用你自己的提示词测试 flux-2-klein-9b/text-to-image，然后再接入批量任务；并可随时在定价页面查看当前费率。完整的请求/响应 schema 和认证设置见API 文档。
