z-image-spicy-pro — 使い方とパラメーター
テキストから画像を生成します。公開モデル ID は z-image-spicy-pro、基本料金は生成成功した画像1枚につき $0.020です。
z-image-spicy-pro
テキストから画像を生成します。公開モデル ID は z-image-spicy-pro、基本料金は生成成功した画像1枚につき $0.020です。
APIMaster API キーを Authorization: Bearer で送信。JSON は Content-Type: application/json、multipart の boundary は cURL/requests に任せます。https://apimaster.ai/v1 は /v1 を含みます。
POST https://apimaster.ai/v1/images/generations · application/json
例は同期エンドポイントです。サーバーは受理済み上流タスクを照会して待機し、クライアントには上流 UUID ではなく最終 Images 結果を返します。読み取りタイムアウトは750秒など十分長く設定し、ストリーミングは使いません。
パラメーター
| フィールド / 型 | 規則と既定値 |
|---|---|
model · string |
必須。上記の正確な公開モデル ID。 |
prompt · string |
必須の空でない文字列。画像の説明または編集指示。 |
n · integer = 1 |
任意の整数。1 のみ対応、既定値 1。 |
response_format · string = url |
任意の文字列。url(既定)または b64_json。 |
width / height · integer = 1024 |
任意の整数。幅・高さはそれぞれ256~2560ピクセル。上流の既定値は1024 × 1024。 |
size · string |
任意の 幅x高さ(例 512x512)または auto。明示した width/height と一致が必要。寸法をすべて省略すると上流の既定値を使用。 |
seed · integer | null = 0 |
任意の整数または null。0~2147483647、既定値 0。0 または null はランダムシードで、再現性を保証しません。 |
prompt_extend · boolean | null = false |
任意の真偽値または null。既定値 false。true は上流によるプロンプトの書き換え・拡張、null は既定動作。 |
quality · standard; stream · false |
非対応:n>1、stream=true、mask/mask_url、style、background、output_format、watermark。quality は省略または standard、追加品質段階はありません。不明な追加パラメーターは拒否します。 |
resolution |
Z Image は参照画像非対応。size または width/height を使用。resolution は省略(旧値 1K は受理しますが寸法を指定しません)。 |
呼び出し例
cURL · JSON
curl --max-time 750 'https://apimaster.ai/v1/images/generations' \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H 'Content-Type: application/json' \
--data '{
"model": "z-image-spicy-pro",
"prompt": "A red paper boat on a calm blue pond, no text.",
"n": 1,
"response_format": "url",
"seed": 0,
"width": 512,
"height": 512,
"prompt_extend": false
}'
Python · requests
import os
import requests
api_base = "https://apimaster.ai/v1"
payload = {
"model": "z-image-spicy-pro",
"prompt": "A red paper boat on a calm blue pond, no text.",
"n": 1,
"response_format": "url",
"seed": 0,
"width": 512,
"height": 512,
"prompt_extend": False
}
response = requests.post(
api_base + "/images/generations",
headers={"Authorization": "Bearer " + os.environ["APIMASTER_API_KEY"]},
json=payload,
timeout=(20, 750),
)
response.raise_for_status()
result = response.json()
print(result)
レスポンスと課金
成功時の HTTP 200 は created(Unix秒)と1要素の data を返します。url はダウンロード先で、速やかに保存してください。b64_json は画像バイトの base64。ステータスだけでなく画像内容も確認します。
{"created": 1793380000, "data": [{"url": "https://example.com/generated.png"}]}
{"created": 1793380000, "data": [{"b64_json": "BASE64_IMAGE_BYTES"}]}
基本料金は画像単位。既存のチャネル・グループ・アカウント倍率を適用した最終額は広場と利用ログで確認します。対応寸法と参照枚数に別途追加料金はありません。例は n=1。
制限とトラブル対応
非対応:n>1、stream=true、mask/mask_url、style、background、output_format、watermark。quality は省略または standard、追加品質段階はありません。不明な追加パラメーターは拒否します。
Z Image は参照画像非対応。size または width/height を使用。resolution は省略(旧値 1K は受理しますが寸法を指定しません)。
400 はパラメーターを修正。上流の拒否・失敗はエラーとして返ります。タイムアウト、切断、受理不明は未生成の証拠ではありません。リクエスト ID を保存し、ログ確認かサポート相談後に新たな有料 POST を判断してください。受理済みタスクは自動再送しません。
画像 API 一覧 · qwen_image_edit_spicy
上流仕様確認日:2026-10-30。本ページは提供中の APIMaster アダプター仕様で、上流の作成・照会 API そのものではありません。
