Qwen Image 3.0 Pro API

Qwen Image 3.0 Pro 画像編集は、参照画像 1〜3 枚を指示どおりに編集します。参照が 1 枚なら、表紙コピー、服、光といったピンポイントの変更です。2〜3 枚なら組み合わせになりますが、どの画像が何を担うかをプロンプトで書く必要があります。

Qwen Image 3.0 Pro は、Alibaba の Qwen 画像シリーズの高精細モデルです。プロンプトは 5,000 文字まで、アスペクト比は 8 種、1K か 2K の 2 段階、参照 1〜3 枚での編集に対応します。納品する画像のためのモデルで、検閲はありません。

手元の素材から Qwen Image 3.0 Pro のモードを選ぶ

文字を踏まえた画面づくり

Qwen Image 3.0 Pro は、渡した文言、構図、画面の処理を一緒に考える必要があるビジュアルのコンセプトに向いています。生成された文字はデザインの下書きとして扱い、公開前に校正してください。

新しく組む仕事と、元画像を手直しする仕事は別

文章のブリーフからビジュアルを立ち上げるならテキストから画像を使います。既存の画像にある人物、レイアウト、素材を保ったまま決まった変更を加えるなら画像編集を使います。

装飾より先に、情報の優先順位を確かめる

ポスター、パッケージ、キャンペーンのコンセプトでは、まずメッセージの優先順位と視線の集まる場所を決めます。見た目がよくても、承認済みの文言や製品の事実が正しく表れていなければ、依頼を果たしたことにはなりません。

手元の画像を仕上げる

承認済みの画像 1〜3 枚を結果に引き継ぎたいときに使います。プロンプトで呼ぶ順番どおりに image_urls に並べ、1 枚目から顔、2 枚目から服、というように役割を与えてください。役割が推測されることはありません。

雑誌の表紙と検閲なしのエディトリアル

承認済みの表紙を残し、1 回に変える要素は 1 つだけにします。表紙コピー、服、光のどれかです。スタイルの変更と文字の差し替えを同じ呼び出しで行うと顔がずれやすいので、2 回のリクエストに分けてください。

ポスターや屋外広告のカンプ

承認済みのポスターの画を使い、次の掲出に向けて日付の行や注意書きを差し替えます。元の文字列と新しい文字列を引用し、aspect_ratio は画の形のままにして、ほかはすべて変えないと書きます。

パッケージやラベルのモックアップ

製品のレンダリングを送り、ラベルを付け替えます。ブランド名と短いコピーを引用し、どの面に載るかを書いて、古いラベルの文字の消し残しには negative_prompt を使います。

# 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-3.0-pro/edit",
  "input": {
    "aspect_ratio": "1:1",
    "image_urls": [
      "https://example.com/reference.png"
    ],
    "num_outputs": 1,
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "resolution": "2k"
  }
}'

# 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 リファレンスを参照してください。