APIMaster.ai

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。

z-image-spicy-pro

制限とトラブル対応

非対応: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 そのものではありません。

MuleRouter API