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。
制限とトラブル対応
非対応: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 を判断してください。受理済みタスクは自動再送しません。
上流仕様確認日:2026-10-30。本ページは提供中の APIMaster アダプター仕様で、上流の作成・照会 API そのものではありません。
