Skip to main content
POST

サポートされているモデル

文字・レイアウトが密集する場合は -pro を推奨。一般的な画像は qwen-image-3.0 を使用。プロンプト上限は約 4.5k トークン。モデル名は 2.0 シリーズと互換ではありません。

Authorizations

string
必須
すべてのエンドポイントは Bearer Token 認証が必要ですAPI Key 管理ページ で API Key を取得してください:

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:4
  • 16:9 / 9:16
  • 3:2 / 2:3
16x9 形式、または 1024x1024 のようなピクセル指定も可。カスタムピクセルでは、各辺(幅・高さ)が 512 ~ 2048、アスペクト 1:8 ~ 8:1。sizeresolution も未設定の場合、出力は 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 との違い

注意事項

  1. 非同期:送信後に task_id が返ります。タスク状態の取得3~5 秒ごとにポーリング。クライアントタイムアウトは約 3 分(2K + 複数枚はより遅い)。
  2. ストレージ:画像はプラットフォーム CDN にミラーされ、長期アクセス可能です。
  3. 課金:納品画像枚数 × 解像度ティア。実際のピクセル面積で判定(> 2.25M ピクセル = 2K)。qwen-image-3.0 は 1K/2K 同額、-pro の 2K は 1K の 2 倍。失敗時は全額返金、参考画像は無料。
  4. エラー:無効な size/比率、画像から画像での agent、到達不可/過大な参考画像 → 400、レート制限 → 429。
結果の照会進捗と result.imagesタスク状態の取得 を使用してください。