メインコンテンツへスキップ
POST

認証

Authorization
string
必須
すべてのリクエストには Bearer Token 認証が必要です。API Key 管理ページ から API Key を取得し、リクエストヘッダーに追加してください:

利用可能なモデル

課金は成功した生成枚数 × 単価で計算されます。入力は課金対象外。解像度とアスペクト比は料金に影響しません。失敗したリクエストは課金されません。

Body

model
string
必須
画像生成モデル名
  • wan2.7-image-pro — プロフェッショナル版、テキスト生成で最大 4K
  • wan2.7-image — スタンダード版、高速、最大 2K
prompt
string
生成する画像のテキスト説明。最大 5000 文字。
  • テキスト生成モードimage_urls なし):必須
  • 画像編集モードimage_urls あり):任意(推奨)
例:"精巧な窓のある花屋、美しい木製ドア、花が飾られている"
image_urls
array<string>
入力画像の URL 配列。画像編集・複数画像参照などのシナリオで使用します。指定すると画像編集モードに自動的に切り替わります。対応形式: HTTP / HTTPS 画像リンク;data:image/...;base64,... Base64 形式制約: 最大 9 枚;JPEG / PNG / WEBP / BMP;240–8000 px;アスペクト比 1:8 ~ 8:1;1 枚あたり ≤ 20MB
出力のアスペクト比は最後の入力画像に自動的に合わせられます。編集モードは最大 2K です(4K 非対応)。
n
integer
デフォルト:"1"
生成する画像の枚数
  • 標準モード:1–4(デフォルト 1)
  • 連続生成モードenable_sequential: true):1–12(デフォルト 1)
成功した生成枚数ごとに課金されます。n に基づいて事前課金されます。
size
string
出力解像度またはアスペクト比。3つの形式をサポートしています:① 解像度キーワード(推奨): 1K / 2K(デフォルト)/ 4Kwan2.7-image-pro テキスト生成のみ)② アスペクト比: 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3(デフォルトでは 2K ティアに換算)③ ピクセル値: 1024x1024 または 1024*1024
resolution
string
解像度キーワード:1K / 2K / 4Ksize(アスペクト比)と組み合わせて使用できます。
negative_prompt
string
ネガティブプロンプト。例:"ぼやけた、歪んだ、低品質"
watermark
boolean
デフォルト:"false"
右下角に「AI 生成」ウォーターマークを追加するかどうか
seed
integer
ランダムシード(0–2147483647)。同じパラメータと同じシードを使用すると、視覚的に一貫した結果を生成できます。
thinking_mode
boolean
デフォルト:"true"
強化推論モード。画像品質が向上しますが生成時間が長くなります。
連続生成モード無効かつ画像入力なしの場合のみ有効です。
enable_sequential
boolean
デフォルト:"false"
連続画像生成モードを有効にします。絵コンテ、漫画、シリーズに最適。
  • 有効時の n 上限は 12
  • 連続生成モードでは thinking_modecolor_palette は無効
  • wan2.7-image-pro の連続生成は最大 2K(4K 非対応)
bbox_list
array
インタラクティブ編集用のバウンディングボックス。編集またはコンテンツ挿入する正確な領域を指定します。構造: [[[x1, y1, x2, y2], ...], ...]
  • 外側の配列長は image_urls の長さと一致する必要があります
  • ボックス不要な画像には [] を渡します
  • 1枚の画像につき最大2ボックス。座標は元画像の絶対ピクセル値で、左上を (0,0) とします
例:[[], [[989, 515, 1138, 681]]]
color_palette
array<object>
カスタムカラーテーマ。標準モードのみ(連続生成モードでは使用不可)。
  • 3–10 項目(8項目推奨)。各項目には hexratio が必要です
  • すべての ratio 値の合計は正確に 100.00% である必要があります

レスポンス

code
string
レスポンスステータス。成功時は "success" を返します。
data
array

利用例

テキストから画像(最小)

テキストから画像(解像度指定)

カスタムカラーテーマ

連続画像生成

単一画像編集

複数画像参照 / 要素融合

インタラクティブ編集(バウンディングボックス)

bbox_listimage_urls と 1 対 1 で対応します。選択範囲がない画像には [] を渡してください。
結果の照会画像生成は非同期です。返却された task_id を使用して タスクステータス エンドポイントを status == completed になるまでポーリングしてください。