各辺が1536ピクセルまでのテキスト生成画像にはZ-Image Spicyを、1画像$0.01235から使ってください。片側が1536を超える必要がある場合は、最大2560ピクセルまで使えるSpicy Proを$0.019で選びます。 どちらも規制なしのテキストから画像へのタスクです。画像参照はどちらも受け取らないため、承認済みの顔をそのまま残す必要がある場面では別の編集ツールを使ってください。
どちらもプロンプト拡張をオフにしたまま、規制なしの指示書をそのまま受け取ります。2026年9月のテストでは、最も強い要望に対してSpicyが一度だけ場面の一部を失いました。Proは失いませんでした（詳細はZ-Imageは規制なしですか？）。以下は、扇を一つ持つ、衣装を着た架空の成人ダンサーの作例です。まずポートレート、次に横長の告知画像を作ります。
画面サイズと価格を一緒に決める
| 設定 | Z-Image Spicy | Z-Image Spicy Pro |
|---|---|---|
| 幅と高さ | それぞれ256–1536 | それぞれ256–2560 |
| 既定値 | 1024 × 1536 | 1024 × 1024 |
| 拡張オフ | $0.01235/画像 | $0.019/画像 |
| 拡張オン | $0.0133/画像 | $0.019/画像 |
| プロンプト長 | 上限なし | 上限なし |
| シード | 0–2147483647 | 同じ |
| ネガティブプロンプト、参照画像、マスク、LoRA | 利用不可 | 利用不可 |
widthとheightを送ります。aspect_ratioフィールドはありません。実用的な画面は、4:5のカードなら960 × 1200、9:16のストーリーの枠なら864 × 1536、16:9なら1536 × 864で、すべて通常のSpicyの範囲内です。2560 × 1440や幅1600ピクセルの枠にはProを選んでください。Spicyは幅1600を拒否し、幅だけを1536に切ると比率が黙って変わります。
請求はピクセルではなく画像ごとの単価です。2560 × 2560のProの枠でも、1024の正方形と同じ$0.019です。小さい下書きで節約できる金額はありません。別の画面では同じシードでも絵柄が変わります。納品する大きさで下書きをしてください。空いた余白そのものを狙っている場面でない限り、長い辺は短い辺のおよそ2倍までに収めます。
まずPlaygroundでポートレートを試す
- Z-Image Spicyのページを開き、PlaygroundタブのForm表示のまま進みます。実行には残高のあるアカウントでサインインします。
- Widthを960、Heightを1200にし、Prompt expansionはオフのまま、Seedに314159のような値を入れます。
- 下のプロンプトをPromptに貼り付けてモデルを実行し、扇と手と靴を確認してから使います。
Z-Imageの兄弟となるテキストから画像へのページで、Spicyのページではありません。PromptフィールドとRunボタンがあるForm表示です。
静かなスタジオで一人で練習する、32歳の架空の成人ダンサーの自然な雑誌風のファッション画像。コバルト色の長袖ブラウス、アイボリーのスカート、簡素な練習靴を着る。全身を穏やかに4分の1回転ほどひねり、両方の靴を木の床に置く。一方の手が肩の横で開いた珊瑚色の折り畳み扇の一本の柄を握り、握っているところが見え、扇は顔から離す。反対の手は力を抜いた姿勢。素の黄土色の壁、柔らかい横からの光、扇の上と靴の下の十分な余白。文字も、鏡も、追加の人物も、余分な扇も入れない。
ネガティブプロンプトの欄がないため、除外したいものはプロンプトに書きます。最後の一文で除外する要素を指定します。扇、手、構図を具体的に説明する言葉は、「傑作」のような形容詞を連ねるより効果的です。最初のポーズは、どの手が物を持っているか分かるくらい静かに保ち、衣装のコンセプトが固まってから、本格的なダンスの動きを試してください。
挿絵であり、対象モデルの結果ではありません。扇の軸に見える握りが、このプロンプトが求める関係です。
候補を比較するには、指示の一部分だけを変えて、毎回新しいシードで実行し直します。PlaygroundのリクエストボディはAPIが受け取るJSONと同じなので、ここで動かした設定はそのままコードに書けます。Proの場合、Z-Image Spicy Proのページを開いて、同じ項目をより大きい上限で使います。
続いてコードから実行する
Python SDK（pip install spicyapi）をインストールし、サーバー環境にSPICY_API_KEYを設定して実行します。
import uuid
from spicyapi import SpicyClient, output_assets
client = SpicyClient() # reads SPICY_API_KEY from the environment
task = client.create_task(
model="alibaba/z-image-spicy/text-to-image",
input_data={
"prompt": "Natural editorial fashion image of one fictional adult dancer aged 32, rehearsing alone in a quiet studio. She wears a cobalt long-sleeved blouse, an ivory skirt and simple rehearsal shoes. Complete body in a gentle quarter turn, both shoes resting on the wooden floor. One hand holds the handle of one open coral folding fan beside her shoulder, with the grip visible and the fan away from her face. Her other hand hangs relaxed. Plain ochre wall, soft side light, generous room above the fan and below the shoes. No lettering, mirrors, extra people or additional fans.",
"width": 960,
"height": 1200,
"enable_prompt_expansion": False,
"seed": 314159,
},
idempotency_key=str(uuid.uuid4()),
)
print("Task", task["taskId"], flush=True)
final = client.wait_for_terminal(task["taskId"])
if final["state"] != "succeeded":
raise RuntimeError(f"{task['taskId']} ended as {final['state']}: {final.get('errorCode')}")
assets = output_assets(final)
if not assets or any(
not asset.get("url") or asset.get("pending") or asset.get("unavailable")
for asset in assets
):
raise RuntimeError(f"{task['taskId']} has no complete downloadable output; look up this task before retrying")
print(assets[0]["url"]) # copy the image to your own storage now作成、完了待ち、ダウンロード、再試行、エラーコードはtasksガイドとPython SDKリファレンスにまとまっています。結果には保存期限があります。返されたリンクを前提に組み立てる前に保持と配信を確認してください。
Agentに実行させる
アシスタントに生成を任せる場合、3つの公式ツールはいずれも価格を表示し、有料の呼び出しの前に確認を求めます。
- CLI. 同じ
inputオブジェクトをinput.jsonに置き、次を実行します。
``bash spicyapi tasks create --model alibaba/z-image-spicy/text-to-image --input-file input.json --wait ``
CLIのドキュメントを参照してください。npx @spicyapi/cliならインストールなしでも動きます。
- MCPサーバー. アシスタントにMCPサーバーを追加し、こう尋ねます。「Run Z-Image Spicy at 960 by 1200 with this prompt, prompt expansion off.」これは
spicyapi_task_createを呼び出し、価格確認のためそこで止まった後、spicyapi_task_waitを呼び出します。 - Skill.
npx skills add spicyapi-ai/spicy-skillはAgent Skillをインストールし、コーディングアシスタントが項目を推測せずに実際のモデルスキーマを読むようにします。
横長画像は、意図的な新しいレイアウトにする
width: 1536、height: 864に変更します。ポートレートのプロンプトで、「全身を穏やかに4分の1回転ほどひねり、両方の靴を木の床に置く」を以下の最初の二文に置き換え、「扇の上と靴の下の十分な余白」を三文目に置き換えます。
ダンサー全体を、画面の左側に、穏やかに4分の1回転ひねった姿勢で置き、両足を木の床に置きます。開いた扇全体が画像の端から離れるように保ちます。右側の3分の1は、別途で加える告知用の文字のための静かな黄土色の壁として空けておきます。
これは新しいテキスト生成画像であり、ポートレートの編集ではありません。同じシードを使っても、承認済みの顔は画面をまたいで引き継がれません。同一の人物を保つ必要がある場合は、選んだポートレートをそのまま使い、バナーには参照に対応した画像編集ツールか、通常の切り抜きとレイアウトの工程を使ってください。
実際のタイトル、日付、会場は、後からデザインツールで加えます。素の黄土色の壁はレイアウトの要望であって、生成された文字が正しく綴られるという約束ではありません。壁が狭すぎた場合は、扇を覆うのではなく、文字を画像の外に出してください。
Proへ移る前に直す失敗例
| 失敗 | 具体的な修正 |
|---|---|
| 扇が手と融合する | 「片手で扇の軸より下の細い柄を握る」と要求し、扇はブラウスの端から離して保つ。 |
| 靴が切られる | 4:5または2:3の縦位置を使う。「両足の下の床が見える全身」と書く。近接表現は外す。 |
| ダンサーが2人出る | 教室、群衆、鏡、パートナーの表現を外し、「一人で練習する1人の成人」は残す。 |
| タイトル用の余白がごちゃつく | 装飾的な窓、壁のパターン、劇的な光線を外し、右側3分の1の無地の壁を要求する。 |
| 扇が顔を覆う | 肩の横に、顔の輪郭の外へ置く。 |
Proは人体の描写やレイアウトを直しません。まず指示書を直し、片側が1536を超える必要があるときだけProへ上げてください。
拡張とシード
プロンプト拡張はオフのままにしてください。生成前にプロンプトを書き換えるため、意図的に選んだ言い回しが一般的すぎる表現に変わる可能性があり、これは成人向けの指示書で特に問題になります。別の場面になっても構わない一行のコンセプトにだけオンにしてください。通常のSpicyでは1画像あたり$0.00095が加算され、Proでは無料です。
モデルページは、シードを省略した場合（または0の場合）はランダムに生成すると説明しています。しかしシードなしの同じ要求を繰り返すと、私たちのテストでは両方のモデルで同じ画像が返りました。候補ごとに異なるseedを送ってください。シードは同じ生成同士を比較可能にしますが、同一の画像を保証するものではないので、数値を頼って再現するのではなく、選んだファイルを保存してください。
挿絵であり、対象モデルの結果ではありません。印刷した紙はポートレートの構想レビューを表します。
予算と決定
プロンプト拡張をオフにした通常の Spicy の候補 4 枚は$0.0494、Pro の候補 4 枚は$0.076です。1536ピクセル以内ならSpicyで始めてください。配置に長い辺が要るときだけProの費用を払い、人体の描写やレイアウトが間違っているときはモデルの種類ではなく指示書を直してください。
