はじめに
Qwen Image 2.1 Image Editing は、1 枚から 10 枚の元画像を文章の指示に沿って書き換え、新しい 1 枚を返します。Alibaba の Qwen チームが 2026 年 9 月 21 日にモデルをオープンウェイト化し、このエンドポイントも同じ日にここで稼働を始めました。
コンテンツフィルターも成人フラグもありません。当方の受け入れ検証では、検閲なしの元画像を渡して指示を通しましたが、被写体に服を着せ直すことも、どこかをぼかすことも、安全な構図へ後退することもありませんでした。多くの編集エンドポイントが検閲なしの用途で使いものにならなくなるのは、まさにこの失敗のためです。
手元の素材から Qwen Image 2.1 のモードを選ぶ
| 手元の素材 | モード |
|---|---|
| 下敷きにする画像が 1〜10 枚 | Qwen Image 2.1 画像編集 |
| 文章のブリーフだけ | Qwen Image 2.1 テキストから画像 |
| 元画像と自前の LoRA ウェイト | Qwen Image 2.1 LoRA 画像編集 |
主な機能とハイライト
1 回のリクエストで参照 10 枚
多くの編集エンドポイントは元画像 1 枚、多くて 3 枚までです。ここでは 10 枚まで読みます。一貫したシリーズが現実的になるのはこの点で、人物を決めた 1 枚を保ったまま、衣装を担う参照を足し、場所を担う参照を足して、1 回につき 1 つだけ変えていけます。
元画像は、送ったとおりのまま
被写体にそっと服を着せてしまう編集エンドポイントは、拒否するエンドポイントよりたちが悪いと言えます。違う絵に対して課金されるからです。当方の検証では、検閲なしの元画像を渡し、そのままの状態で新しい要素を加えるよう指示しました。返ってきたのはまさにそれで、挙げた要素はすべて描かれていました。
参照ごとに課金されるので、見積もりは指示の形に従う
枚数を足せば費用はそのぶん直線的に上がり、送信前に表示される見積もりがそのまま確定額になります。同じ段階でも 10 枚のリクエストは 1 枚の数倍です。効いている参照だけを送り、残りは落とす理由がここにあります。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 5,000 文字まで。この系列にネガティブプロンプトはないので、除外したいものもここに書きます。 1 文字以上 · 5000 文字以内 |
image_urls | はい | 参照画像を 1〜10 枚。モデルは役割を自分で割り当てないので、どの画像が何を担うのか——どれが人物で、どれが背景で、どれが衣装なのか——をプロンプトに書いてください。 1 件以上 · 10 件以内 |
mask_url | いいえ | 編集を部分編集モードに切り替える、任意の白黒画像です。白が描き直す範囲、黒はそのまま残る範囲で、境界を数ピクセルぼかすとなじみがよくなります。 |
aspect_ratio | いいえ | 生成後に切り抜くのではなく、生成前に構図を組みます。実際に掲載する形をそのまま選んでください。 |
resolution | いいえ | 出力サイズと価格を決める段階です。1k が既定でいちばん安く、1.5k はその中間、肌の質感や髪、布の織り目が保たれるのは 2k です。 |
enable_prompt_expansion | いいえ | 既定はオンです。生成の前に、プロンプトをより詳しい情景描写に書き換えます。 デフォルト値: |
background | いいえ | 既定は opaque です。transparent にすると被写体だけを本物のアルファチャンネル付きで返します。 |
output_format | いいえ | 既定は JPEG です。合成工程に渡すなら PNG、そのままページに載せるなら WebP。 |
seed | いいえ | 一連の絵が似た方向に収まるよう、揺れを抑えます。再現の保証ではありません。 |
料金
| 仕様 | 料金 |
|---|---|
| $0.036 / 枚 |
| $0.048 / 枚 |
| $0.072 / 枚 |
ユースケース
シリーズ全体で同じ人物を保つ
承認済みの 1 枚を同一性の参照として持ち続け、画像ごとに指示だけを変えて回します。seed が顔を再現してくれることを期待するより、はるかに安定します。
既存の人物から組み立てる場面
手元にある人物から始めて、2 人目、小道具、場所を足していきます。指示は書いたとおりに実行されます。
衣装と場所の差し替え
参照は 2 枚——人物用と、衣装または部屋用——に、どちらがどちらかを書いたプロンプトを添えるだけです。
残した 1 枚を文脈ごと引き上げる
場面を作り直さずにディテールだけ欲しいときは、1k の絵を構図を保つ指示付きで 2k の編集として回します。
プロンプトガイドと実践のヒント
参照ごとに、何を担うのかを書く
モデルは役割を推測しません。「1 枚目が女性、2 枚目が彼女の立っている部屋です」——この一文があるかどうかが、編集になるか混ざるかの分かれ目です。
変えてはいけないものを書く
ここにネガティブプロンプトはないので、守りたいことは本文の指示に入れます。「元画像のとおりにし、衣装には何も加えないこと」——編集モデルが「隠すべき」と判断して被写体を覆ってしまうのを止めるのは、この一文です。
参照は少なく、質の高いものを
同一性は 1 枚のきれいな元画像からはよく保たれ、枚数を重ねるほど揺れます。1 枚ごとに価格も上がるので、少ないほうがたいてい安く、そして精度も上がります。
段階だけでなく見積もりを見る
このエンドポイントでは、参照の枚数が解像度の段階と同じくらい価格を動かします。送信前の見積もりが最終的な根拠です。10 枚のリクエストを送る前に、必ず目を通してください。
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/qwen-image-2.1/edit",
"input": {
"aspect_ratio": "1:1",
"background": "opaque",
"image_urls": [
"https://example.com/reference.png"
],
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# 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 リファレンスを参照してください。
