はじめに
Z-Image Spicy は、検閲なしのブリーフもそうでないブリーフも、自分で決めた寸法の 1 枚の画像にします。設定を緩めた汎用モデルではなく、検閲なしの専用モデルです。リクエストとモデルの間に、成人フラグも、申告も、検査もありません。
Z-Image Spicy は Z-Image シリーズの検閲なしモデルです。幅と高さを 1536 までのピクセル数で正確に指定でき、プロンプトの長さに制限はなく、任意のプロンプト拡張は初期状態でオフ、経路のどこにもコンテンツフィルターはありません。
主な機能とハイライト
検閲なしの画像のための専用モデル
Z-Image Spicy は、制限を緩めた汎用の経路ではなく、検閲なしのビジュアルのブリーフのためのモデルです。想定する文脈、被写体、画面の処理をはっきり書き、そのうえで結果を、書いたブリーフと適用される方針に照らして確認してください。
意図した言葉選びもアートディレクションの一部
承認したブリーフは、選んだ結果と一緒に残してください。そうすれば、後のバリエーションで視覚的な判断を 1 つ変えても、リクエストの意図や範囲が知らないうちに変わることはありません。
使う場所で構図を確かめる
被写体、ポーズ、場面、光は、画像を実際に使う場所で判断します。サムネイルでそれらしく見えても、選んだ 1 枚が納品時に必要な視覚的な関係を失っていれば足りません。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 文字数の上限はありません。光の向き、衣装の素材感、フィルムの質感、パレットに字数を使ってください。 1 文字以上 |
width | いいえ | 出力の横幅（px）。256〜1536 で、height とは独立に指定します。 |
height | いいえ | 出力の高さ（px）。256〜1536 で、width とは独立に指定します。 |
enable_prompt_expansion | いいえ | 短いプロンプトを生成前に長く書き直します。既定はオフで、検閲なしの指示文ではオフのままが無難です。 デフォルト値: |
seed | いいえ | 同じ prompt と同じ寸法に同じ seed を渡すと、2 回の実行で乱数がそろいます。おかげで両者を比べられますが、まったく同じ画像が返ることは保証しません。 |
料金
| 仕様 | 料金 |
|---|---|
| $0.01235 / 枚 |
| $0.0133 / 枚 |
ユースケース
文章のブリーフから始める
検閲なしのものでもそうでないものでも、正確なピクセル寸法が必要なブリーフに使います。width と height を 256〜1536 で指定し、書いた言葉がそのまま届くよう enable_prompt_expansion はオフのままにして、ルックが決まったら seed を固定します。
ほかの画像 API が断るプロンプト
フィルターのあるエンドポイントが拒む検閲なしの言い回しも、そのまま渡されます。拡張がオフなら、途中で言い換えられることもありません。タスクの流れはここのほかのモデルと同じで、作成し、ポーリングし、プラットフォームのストレージから受け取ります。
掲載枠にぴったりの素材
カードのアートは 832x1216、ヘッダーは 1536x512、正方形のサムネイルは 512x512。すべて同じエンドポイントから、切り抜きではなくその寸法で生成するので、被写体はレイアウトが想定する位置に収まります。
ポートレートとファッションのシリーズ
ブラインド越しの硬い光、しわの寄ったリネン、レースやシルクを、好きな大きさで作ります。ルックが決まったら seed を固定し、同じ被写体で部屋や衣装を変えて何枚も作れば、1 回の撮影のように読めるシリーズになります。
プロンプトガイドと実践のヒント
全文の指示を書く（拡張はオフ）
文字数の上限はないので、衣装、光の向き、フィルムの質感、パレットを書き切ってください。公開している静止画は、次のプロンプトから作りました。「Photograph of an adult woman lying on her side across rumpled white linen in a black lace bodysuit, morning sun through venetian blinds casting hard stripes across her skin and the sheets, one arm stretched above her head, eyes closed, calm and warm, medium format film look, soft grain, honey and cream palette.」
画像の大きさはピクセルで書く
比率を選ぶのではなく、掲載枠に合わせて幅と高さを指定します。縦位置のポートレートなら 1024x1536、ヘッダーなら 1536x640、サムネイルなら 512x512 です。どちらの辺も 256〜1536 の値を受け付けます。
付属の例を作り替える
公開している例から始め、height は 1536、width は 1024 にします。被写体と演出を入れ替えつつ、このモードの入力の決まりはそのまま保ちます。
Photograph of an adult woman lying on her side across rumpled white linen in a black lace bodysuit, morning sun through venetian blinds casting hard stripes across her skin and the sheets, one arm stretched above her head, eyes closed, calm and warm, medium format film look, soft grain, honey and cream palette.
このエンドポイントの参照画像の元になったプロンプトです。1024x1536 で、書いた言葉がそのままモデルに届くよう拡張はオフにしています。掲載している画像は、同じシリーズの Turbo モデルでスタイル参照として作ったものです。
反復する前に結果を確かめる
1 辺の上限は 1536 ピクセルなので、印刷サイズの納品には向きません。大きな画像が必要なら、ここで生成してほかでアップスケールしてください。極端な縦横の組み合わせは、モデルがうまく構図を組める範囲を超えます。余白を意図しているのでなければ、長い辺は短い辺のおよそ 2 倍までにしてください。検閲なしのブリーフでは enable_prompt_expansion をオフのままにするのが確実です。オンにすると、選んだ正確な言葉が一般的な表現に置き換わることがあります。このエンドポイントには、ネガティブプロンプトも画像の入力もありません。
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/z-image-spicy/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"enable_prompt_expansion": false
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。
