z-image-spicy/text-to-image API の使い方：テキストから画像生成統合ガイド（2026）

z-image-spicy/text-to-image は Z Image Spicy のテキストから画像生成モデルです：テキストから高品質な画像を生成。256〜1536 ピクセルのカスタムサイズ、プロンプト拡張、シード制御に対応し、クリエイティブ制作や一括生成に適しています。NamiFusion では Playground で試してから（送信前に見積もり表示）、統一 REST API で呼び出せます（1 回あたり約 $0.014）。

TL;DR

· タスク種別：テキストから画像生成（提供：Z Image Spicy）

· 料金：1 回あたり約 $0.014（$1 = 100 クレジット）、従量課金

· 始め方：Playground で試用（送信前に見積もり）→ API キー作成 → POST 一発で統合

· 調整可能パラメータ：5 個（下表参照）

· プラットフォーム透かしなし。商用利用可（利用規約に従う）

z-image-spicy/text-to-image で何が作れる？

SNS 用ビジュアルやカバー画像：テーマに沿って一括生成し、そのまま投稿予約。

EC・広告素材：商品シーン、バナー背景、A/B テスト用の複数バリエーション。

コンセプトアートと発想出し：キャラクター・背景・スタイルボードを低コストで高速に反復。

ワークフロー連携：生成結果をそのまま画像→動画や顔交換の入力素材に。

この API はどう呼び出す？

1. NamiFusion に登録し、API Keys ページでキーを作成（登録特典クレジットは指定モデルのみ対象）。
2. 下記の cURL 例でタスクを送信。Bearer トークンにキーを指定。
3. 返された task_uuid でステータスをポーリングし、完了後に出力 URL を取得。

# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/z-image-spicy/text-to-image" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "prompt": "A cinematic portrait of an astronaut in a bioluminescent forest at dusk, intricate suit details, soft blue light, photorealistic.",
    "width": 1024,
    "height": 1536,
    "prompt_extend": true
  }
}'

# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
  -H "Authorization: Bearer YOUR_API_KEY"

どんなパラメータがある？

prompt（プロンプト）：必須

width（幅）：任意、デフォルト 1024

height（高さ）：任意、デフォルト 1536

prompt_extend（プロンプト拡張）：任意、デフォルト true

seed（シード）：任意

z-image-spicy/text-to-image のプロンプトの書き方は？

1. 主体を先に：主役と動作を先に書き、環境・光・スタイルを後から足す（「雨のネオン街を走る宇宙飛行士、シネマティック、浅い被写界深度」）。
2. 形容詞の羅列より具体名詞：「85mm ポートレートレンズ、夕暮れの逆光」は「とても綺麗、超高品質」より遥かに効く。
3. 1 回の反復で変えるのは 1 変数だけ：seed を固定して再現し、語句を 1 つずつ調整する。
4. 否定は肯定で書く：「ぼかさない」ではなく「シャープなフォーカス、精細なディテール」と指定。

料金はいくら？

従量課金（クレジット制）。1 回あたり約 $0.014（$1 = 100 クレジット）。解像度や長さなどで変動し、Playground では送信前に正確な見積もりが表示されます。