APIMaster.ai

qwen_image_edit_spicy — 使い方とパラメーター

画像編集モデルです。公開モデル ID は qwen_image_edit_spicy、基本料金は成功画像1枚につき $0.040です。APIMaster にはこのアンダースコア付き ID を送信します。

qwen_image_edit_spicy

画像編集モデルです。公開モデル ID は qwen_image_edit_spicy、基本料金は成功画像1枚につき $0.040です。APIMaster にはこのアンダースコア付き ID を送信します。

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。
image · string 必須の主画像。アクセス可能な画像 URL またはデータ URI(data:image/png;base64,...)。
reference_images · string[] | null = null; [] 任意の文字列配列。追加参照画像は最大2枚、URL/データ URI 形式。主画像を含め合計最大3枚。
images / image_urls · string[] 代替の順序付き画像配列。先頭が主画像、残り最大2枚が参照。重複を避けるため入力方式は一つに統一。
seed · integer | null = null 任意の整数または null、既定値 null。0 または null はランダムシード。数値範囲は未公開で、Z Image の範囲を流用しません。
size · string = auto 任意。auto のみ。出力寸法は主画像に従うため width/height は送信しません。
quality · standard; stream · false 非対応:n>1、stream=true、mask/mask_url、style、background、output_format、watermark。quality は省略または standard、追加品質段階はありません。不明な追加パラメーターは拒否します。
resolution Qwen は主画像1枚と参照最大2枚。JSON は image、images、image_urls、reference_images の順に統合。image と reference_images のみの使用を推奨。prompt_extend と明示寸法は非対応、resolution は省略。

呼び出し例

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": "qwen_image_edit_spicy",
  "prompt": "Change the red paper boat to blue. Keep the pond and lighting unchanged.",
  "n": 1,
  "response_format": "url",
  "seed": 0,
  "image": "https://example.com/primary.png",
  "reference_images": [
    "https://example.com/reference.png"
  ]
}'

Python · requests

import os
import requests

api_base = "https://apimaster.ai/v1"
payload = {
    "model": "qwen_image_edit_spicy",
    "prompt": "Change the red paper boat to blue. Keep the pond and lighting unchanged.",
    "n": 1,
    "response_format": "url",
    "seed": 0,
    "image": "https://example.com/primary.png",
    "reference_images": [
        "https://example.com/reference.png"
    ]
}
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)

cURL · multipart

multipart /images/edits では image、繰り返す image[]、または images で画像ファイルを送信。各1バイト~10 MiB、先頭が主画像です。ファイルフィールドは統一。multipart の reference_images は URL/データ URI 文字列の JSON 配列。

curl --max-time 750 'https://apimaster.ai/v1/images/edits' \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -F 'model=qwen_image_edit_spicy' \
  -F 'prompt=Change the red paper boat to blue.' \
  -F 'n=1' \
  -F 'response_format=b64_json' \
  -F 'seed=0' \
  -F 'image[]=@primary.png' \
  -F 'image[]=@reference.png'

レスポンスと課金

成功時の 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。

qwen_image_edit_spicy

制限とトラブル対応

非対応:n>1、stream=true、mask/mask_url、style、background、output_format、watermark。quality は省略または standard、追加品質段階はありません。不明な追加パラメーターは拒否します。

Qwen は主画像1枚と参照最大2枚。JSON は image、images、image_urls、reference_images の順に統合。image と reference_images のみの使用を推奨。prompt_extend と明示寸法は非対応、resolution は省略。

400 はパラメーターを修正。上流の拒否・失敗はエラーとして返ります。タイムアウト、切断、受理不明は未生成の証拠ではありません。リクエスト ID を保存し、ログ確認かサポート相談後に新たな有料 POST を判断してください。受理済みタスクは自動再送しません。


画像 API 一覧 · z-image-spicy-pro

上流仕様確認日:2026-10-30。本ページは提供中の APIMaster アダプター仕様で、上流の作成・照会 API そのものではありません。

MuleRouter API