使用ガイド
Z-Image API：1枚あたり$0.008、実際の出力とコード
HiAPI上のZ-Image：料金、テキスト入りの商品画像4枚、文字を正確に保つプロンプトのルール、そのまま実行できるcurlとPythonのサンプル。
ひとことで言うと
- Z-Image は Alibaba の通義（Tongyi）が発表した高速なテキスト→画像モデルです。HiAPI ではモデル id は
z-image、料金は1枚あたり $0.008：1,000枚で合計 $8 です。 - リクエストに含めるのは2つのフィールドだけです：
prompt（最大1,000文字）とaspect_ratio（1:1、4:3、3:4、16:9、9:16）。サイズ、解像度、seed、画像入力はありません。 - 短い英語テキストを載せた写真級の商品画像の生成が得意です。以下の4つのテストでは、すべての文字が正しく出力されました。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 上の他の低コストモデルとの比較：
| モデル | 1枚あたり | 画像内の文字 |
|---|---|---|
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）
スタジオ撮影のEC商品写真：マットブラックの真空断熱ステンレス製ウォーターボトルを、継ぎ目のないライトグレーの背景の中央に配置し、柔らかな影を落とす。ボトルのそばに長方形のコーラル色の紙カードを立てかける。カードには以下の2行の太字で端正なサンセリフ体のテキストのみを記載し、他の単語は一切入れない：1行目「SUMMER SALE」、2行目「$19.99」。テキストはカメラに正対して平面に配置され、大きく完全に判読可能。フォトリアル。
z-image、1:1、1536×1536、$0.008。
2行のテキストはどちらも正しく出力されました。カードはボトルのそばに立てかけられるのではなく、最終的にボトルのハンドルに引っかかった形になりました。このプロンプトの初版は「reads exactly: SUMMER SALE on the first line and $19.99 on the second line」と書いていましたが、その結果モデルは2行の間に余分な単語「ON」を1つ印字してしまいました。正確なテキストは引用符で囲み、説明は引用符の外に書いてください。
ワイドバナー（16:9）
ワイドなECプロモーションバナー、フォトリアルなフラットレイ撮影：白いスニーカーとクラフト紙の配送箱を、淡いブルーの背景に配置する。右側に太字のネイビーのサンセリフ体テキストで、以下の4語と金額のみを記載し、他には何も入れない：「FREE SHIPPING OVER $50」。この4語はすべて必ず表示すること。テキストは大きく、まっすぐで、完全に判読可能。クリーンな商業スタジオ照明。
z-image、16:9、1344×768、$0.008。
SNSカード（3:4）
縦型のSNS商品カード：小さな茶色のガラス製化粧品スポイトボトルを、温かみのあるベージュの台座に置き、柔らかな自然光。ボトルの上方に太字の黒いモダンなサンセリフ体の見出しテキストで、ちょうど次の内容を表示：30% OFF TODAY ONLY。テキストはカメラに正対して平面に配置され、大きく完全に判読可能。ミニマルでハイエンドなECスタイル、フォトリアル。
z-image、3:4、928×1232、$0.008。
テキストは正しく出力されましたが、スポイトが「ONLY」という単語に重なっています。見出しを必ずはっきり見せたい場合は、商品の位置を指定してください（「in the lower half, below the text」、つまり下半分、テキストの下）。
小さなラベルのテキスト（3:4）
マクロ撮影のEC商品写真：すりガラス製のスキンケアボトルに、清潔感のある白いラベルを貼る。ラベルのテキストはエレガントな濃色のサンセリフ体で印刷され、ちょうど次の内容を表示：1行目 GLOW SERUM、2行目 VITAMIN C 10%。正面からの平視アングル、ラベルは完全に見えてシャープ、柔らかなスタジオ照明、フォトリアル、白背景。
z-image、3:4、928×1232、$0.008。
曲面に載る小さなテキストは4つの中で最も難しい条件でしたが、出力はきれいでした。モデルは「VITAMIN C 10%」を2行に分けてレイアウトしました。
テキストを正しく出力させるためのルール
- 正確なテキストを引用符で囲む。
- 「and no other words」（他の単語を入れない）を加え、モデルが余計なバッジ文言を作り出さないようにする。
- テキストをカメラに正対させ、平面に配置する。傾いたり曲がったテキストが最初に崩れる。
- 1枚につきテキストの塊は1〜2個まで。長いコピーは後からデザインツールで組む。
- 公開前に必ず確認する。$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> で送信してください。同じキーがすべてのモデルで使えます。
中国語のテキストも描画できますか？
Alibaba はバイリンガルテキストを強みとして挙げています。上記の4つのテストはすべて英語だったため、中国語の出力に頼る前に、ご自身のプロンプトで確認してください。
解像度の設定はありますか？
ありません。出力サイズはアスペクト比によって決まります：上記のテストでは、1:1 は 1536×1536、16:9 は 1344×768、3:4 は 928×1232 が返りました。
コードを書かずにプロンプトを試したい場合はZ-Image モデルページを開いてください。
