使用指南
Z-Image API：每张图片 $0.008，真实输出与代码
Z-Image 在 HiAPI 上：定价、四张带文字的商品图、让文字保持正确的提示词规则，以及可直接运行的 curl 和 Python 示例。
一句话总结
- Z-Image 是阿里巴巴通义推出的快速文生图模型。在 HiAPI 上，模型 id 为
z-image，费用为每张图 $0.008：1,000 张图共 $8。 - 请求只包含两个字段：
prompt（最多 1,000 个字符）和aspect_ratio（1:1、4:3、3:4、16:9、9:16）。没有尺寸、分辨率、seed 或图像输入。 - 它擅长生成带简短英文文字的照片级商品图。在以下四项测试中，每一处文字都正确输出。打开 Z-Image 模型页面即可试用；新账户可获得 200 个免费额度。
定价
| 图片数量 | z-image 费用 |
|---|---|
| 1 | $0.008 |
| 100 | $0.80 |
| 600（200 个商品 × 3 张图） | $4.80 |
| 1,000 | $8.00 |
HiAPI 实时价格，查询于 2026 年 10 月 20 日。所有宽高比统一价格。失败的任务不收费。
与 HiAPI 上其他低成本模型对比：
| 模型 | 每张图 | 图片上的文字 |
|---|---|---|
flux-schnell/text-to-image |
$0.005 | 非其强项 |
z-image |
$0.008 | 简短英文文字，在我们的测试中稳定可靠 |
qwen-image-2.1-turbo |
$0.02 | 支持中英文；还可接收参考图 |
gpt-image-2/text-to-image |
1K 分辨率下 $0.03 | 表现强；还可编辑图片 |
更多选择（包括视频）请见HiAPI 上最便宜的图像和视频 API。
真实输出：带文字的商品图
价格标签（1:1）
影棚电商商品摄影：一个哑光黑色保温不锈钢水瓶居中放置在无缝浅灰色背景上，带有柔和阴影。一张长方形珊瑚色纸质卡片斜靠在水瓶旁。卡片上只有以下两行粗体、整洁的无衬线文字，没有其他单词：第一行"SUMMER SALE"，第二行"$19.99"。文字正对镜头、平铺，大号且完全清晰可读。照片级真实感。
z-image，1:1，1536×1536，$0.008。
两行文字都正确。卡片最终挂在水瓶的手柄上，而不是斜靠在瓶旁。此提示词的第一版写的是"reads exactly: SUMMER SALE on the first line and $19.99 on the second line"，结果模型在两行之间多印了一个单词"ON"。请把准确文字放进引号，并把说明写在引号之外。
宽幅横幅（16:9）
宽幅电商促销横幅，照片级真实感的平铺摄影：白色运动鞋和一个牛皮纸运输箱放在柔和蓝色背景上。右侧为粗体海军蓝无衬线文字，内容正好是这四个单词和金额，没有其他内容："FREE SHIPPING OVER $50"。这四个单词都必须出现。文字大号、平直、完全清晰可读。干净的商业影棚灯光。
z-image，16:9，1344×768，$0.008。
社交媒体卡片（3:4）
竖版社交媒体商品卡片：一个小棕色玻璃化妆品滴管瓶放在温暖的米色展示台上，柔和的日光。瓶子上方为粗体黑色现代无衬线标题文字，内容正好是：30% OFF TODAY ONLY。文字正对镜头、平铺，大号且完全清晰可读。极简高端电商风格，照片级真实感。
z-image，3:4，928×1232，$0.008。
文字正确，但滴管与单词"ONLY"重叠了。如果标题必须保持清晰，请说明产品的位置（"in the lower half, below the text"，即下半部分、文字下方）。
小号标签文字（3:4）
微距电商商品摄影：一个磨砂玻璃护肤品瓶，带有干净的白色标签。标签文字以优雅的深色无衬线字体印刷，内容正好是：第一行 GLOW SERUM，第二行 VITAMIN C 10%。正面平视角，标签完全可见且清晰，柔和影棚灯光，照片级真实感，白色背景。
z-image，3:4，928×1232，$0.008。
曲面上的小号文字是四者中最难的，但输出很干净。模型把"VITAMIN C 10%"排成了两行。
让文字正确输出的规则
- 把准确文字放进引号。
- 加上"and no other words"（不要其他单词），这样模型就不会编造额外的徽章文案。
- 让文字正对镜头、平铺。倾斜或弯曲的文字最先出错。
- 每张图只放一到两个文字块。更长的文案之后在设计工具里排版。
- 每张图发布前都检查。按 $0.008 的价格，重新生成一次的成本几乎可以忽略不计。
curl
curl -s -X POST https://api.hiapi.ai/v1/tasks \
-H "Authorization: Bearer $HIAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "z-image",
"input": {
"prompt": "A cozy coffee shop at golden hour, a wooden A-frame sign on the sidewalk reading \"FRESH COFFEE\", warm window light, photorealistic",
"aspect_ratio": "16:9"
}
}'
你会收到一个 taskId。轮询 GET https://api.hiapi.ai/v1/tasks/{taskId}，直到 data.status 为 success，然后下载 data.output[0].url。状态会依次经过 queued、handling 和 archiving，最终变为 success 或 fail。链接在任务完成后约 7 天过期。
Python：小批量处理
# pip install requests；先执行 export HIAPI_KEY=your-key
import os, time, requests
API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}
def submit(prompt, ratio="1:1"):
r = requests.post(API, json={"model": "z-image", "input": {"prompt": prompt, "aspect_ratio": ratio}},
headers=H, timeout=30).json()
if r.get("code") != 200:
raise RuntimeError(r)
return r["data"]["taskId"]
def wait(task_id, timeout_s=300):
deadline = time.time() + timeout_s
while time.time() < deadline:
d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
if d["status"] in ("success", "fail"):
return d
time.sleep(3)
raise TimeoutError(task_id)
products = {"mug-sage": "sage green", "mug-navy": "navy blue", "mug-terracotta": "terracotta"}
tasks = {sku: submit(f'Studio photo of a {color} ceramic coffee mug on white, a small card reads "NEW"')
for sku, color in products.items()} # 先全部提交，再统一收集
for sku, task_id in tasks.items():
d = wait(task_id)
if d["status"] == "success":
with open(f"{sku}.png", "wb") as f:
f.write(requests.get(d["output"][0]["url"], timeout=120).content)
else:
print(sku, "failed:", d.get("error"))
参数与错误
| 字段 | 是否必填 | 取值 |
|---|---|---|
prompt |
是 | 最多 1,000 个字符 |
aspect_ratio |
否 | 1:1、4:3、3:4、16:9、9:16 |
以下情况会在提交时返回 HTTP 400，不会创建任务也不会计费：
additional properties 'size' not allowed（或resolution、width）：请改用aspect_ratio。aspect_ratio: value must be one of ...：不支持 21:9 或 4:5。请先生成 16:9 或 3:4 再裁剪。- 使用类似
z-image-turbo的模型 id：HiAPI 上唯一的 id 是z-image。
何时应改用其他模型
- 需要编辑已有图片：Z-Image 只能从文本生成。请使用图生图模型，例如
qwen-image-2.1-turbo（$0.02）或gpt-image-2/image-to-image。 - 文字较长或密集，或大量中文：试试 Qwen Image，它专为双语排版打造。
- 追求最低价格且不需要文字：
flux-schnell/text-to-image为 $0.005。
常见问题
模型 id 是什么？
z-image。HiAPI 上没有单独的 z-image-turbo id；Turbo 是这个快速变体在上游的名称。
如何获取 API 密钥？
在 hiapi.ai 注册，在控制台创建一个密钥，并以 Authorization: Bearer <key> 发送。同一个密钥适用于所有模型。
它能渲染中文文字吗？
阿里巴巴将双语文字列为强项。以上四项测试全部为英文，因此在依赖它之前，请先用你自己的提示词检查中文输出。
有分辨率设置吗？
没有。输出尺寸随宽高比而定：在上述测试中，1:1 返回 1536×1536，16:9 返回 1344×768，3:4 返回 928×1232。
不想写代码就试提示词？打开 Z-Image 模型页面。
