Qwen Image 3.0
Qwen Image 3.0 画像生成
- 非同期処理モード、後続の照会用にタスク ID を返します
- テキストから画像、画像から画像(1-3 枚の参考画像による編集)をサポート
- 1K / 2K 解像度をサポート、1 リクエストあたり最大 6 枚
- 標準版と Pro 版(Pro は密集レイアウトと文字に強い)
POST
サポートされているモデル
Authorizations
string
必須
Body
string
必須
モデル名
qwen-image-3.0- 標準qwen-image-3.0-pro- Pro(密集テキスト / レイアウト)
string
必須
画像生成用のテキスト説明、最大約 4.5k トークン
string[]
参考画像 URL 配列(画像から画像 / 編集)、1-3 枚
- 公開
http(s)://URL またはdata:image/png;base64,...(base64 は先に再アップロードされます) - 形式:JPG / JPEG / PNG / BMP / TIFF / WEBP / GIF
- 1 ファイルあたり ≤ 10MB、幅/高さは 384-2048 px を推奨
string
デフォルト:"1K"
解像度ティア(課金ティアに影響)
1K(デフォルト、小文字も可)2K
size にピクセルを指定することもできます(例:1600x900)。生ピクセル指定時、面積が > 2.25M ピクセル の場合は 2K として課金されます。string
デフォルト:"1:1"
アスペクト比、または明示的なピクセルサイズサポートされる比率:
1:1(デフォルト)4:3/3:416:9/9:163:2/2:3
16x9 形式、または 1024x1024 のようなピクセル指定も可。カスタムピクセルでは、各辺(幅・高さ)が 512 ~ 2048、アスペクト 1:8 ~ 8:1。size も resolution も未設定の場合、出力は 1024×1024 固定です。integer
デフォルト:"1"
画像枚数、1-6。6 を超える値は 6 にクランプされます。
string
ネガティブプロンプト:避けたい内容
boolean
デフォルト:"false"
インテリジェントなプロンプト書き換えデフォルトは オフ(結果を予測可能にするため)。スマート書き換えを使う場合は
true を指定してください。string
書き換えモード(3.0 シリーズのみ、
prompt_extend: true が必要)direct- テキストから画像、画像から画像の両方で有効agent- テキストから画像のみ、より積極的な書き換え
サイズ対照表
resolution(ティア)+ size(比率)を組み合わせます:
使用例
テキストから画像(複数)
密集レイアウト + 書き換え
画像から画像(編集)
ネガティブプロンプト
制限
Response
integer
ステータスコード、成功時は 200
array
レスポンスデータ配列
2.0 との違い
注意事項
- 非同期:送信後に
task_idが返ります。タスク状態の取得 を 3~5 秒ごとにポーリング。クライアントタイムアウトは約 3 分(2K + 複数枚はより遅い)。 - ストレージ:画像はプラットフォーム CDN にミラーされ、長期アクセス可能です。
- 課金:納品画像枚数 × 解像度ティア。実際のピクセル面積で判定(> 2.25M ピクセル = 2K)。
qwen-image-3.0は 1K/2K 同額、-proの 2K は 1K の 2 倍。失敗時は全額返金、参考画像は無料。 - エラー:無効な size/比率、画像から画像での
agent、到達不可/過大な参考画像 → 400、レート制限 → 429。
結果の照会進捗と
result.images は タスク状態の取得 を使用してください。