画像編集 API
テキストプロンプトを使って画像の編集やスタイル変換、複数の参照画像の合成が可能です。POST /v1/images/edits で 6 種類のモデルが参照画像に対応しています。
モデル
以下のすべてのモデルが参照画像に対応しています。URL を image_urls に渡してください。各モデルが受け入れ可能な枚数は表に記載されています。
| モデルとAPIモデルID | オプション | official-cheap（デフォルト）での価格 |
|---|---|---|
GPT Image 2openai/gpt-image-2 | サイズ: 1K, 2K, 4K最大 16 枚の参照画像 | 1K画像あたり $0.032official: $0.053 |
Nano Banana 2google/nano-banana-2 | サイズ: 1K, 2K, 4K最大 14 枚の参照画像 | 1K画像あたり $0.034official: $0.067 |
Nano Banana 2.1google/nano-banana-2.1 | サイズ: 1K, 2K, 4K最大 14 枚の参照画像 | 1K画像あたり $0.017official: $0.034 |
Nano Banana Progoogle/nano-banana-pro | サイズ: 1K, 2K, 4K最大 14 枚の参照画像 | 1K画像あたり $0.067official: $0.134 |
Qwen Image 2.1 Proqwen/qwen-image-2.1-pro | サイズ: 1K, 2K最大 3 枚の参照画像 | 1画像あたり $0.035official: $0.038 |
Qwen Image 2.1 Turboqwen/qwen-image-2.1-turbo | サイズ: 1K, 2K最大 3 枚の参照画像 | 1画像あたり $0.014official: $0.015 |
クイックスタート
- APIキーを作成する
コンソールでキーを作成し、環境変数 MLMUX_API_KEY として保存します。
APIキーを作成 - リクエストを送信する
この例では Nano Banana Pro（google/nano-banana-pro）を https://api.mlmux.com/v1/images/edits に送信します。モデルIDは上記の表にある任意のモデルに変更できます。
- 結果を確認する
レスポンスの data に画像URLのリストが含まれます。代わりにポーリング用のタスクを取得するには "async": true を追加してください。
画像APIリファレンス
curl https://api.mlmux.com/v1/images/edits \
-H "Authorization: Bearer $MLMUX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "google/nano-banana-pro",
"route_mode": "official-cheap",
"prompt": "Place the product on a sunlit marble counter and keep the label unchanged",
"image_urls": [
"https://your-cdn.example/product.jpg"
],
"resolution": "2K",
"aspect_ratio": "match_input_image",
"output_format": "png"
}'よくある質問
画像編集にはどのモデルを使うべきですか？
Nano Banana Pro は複数の参照画像を用いた複雑な編集に優れています。日常的な編集には低コストな Nano Banana 2 および 2.1 が適しており、GPT Image 2 は最大16枚の参照画像に対応します。最も低コストな選択肢は Qwen Image 2.1 Turbo です。
画像編集の料金はいくらですか？
画像編集は同サイズの画像生成と同じ価格設定となっており、デフォルトルートでは1枚あたり約 $0.014（Qwen Image 2.1 Turbo）からご利用いただけます。
編集する画像はどのように送信すればよいですか？
公開 URL を image_urls に渡すか、POST /v1/uploads でファイルをアップロードして返された URL を使用してください。レスポンスに編集後の画像 URL 一覧が含まれます。
失敗したリクエストにも課金されますか？また、制限はありますか？
失敗したリクエストには課金されず、保留されていたクレジットは残高に返還されます。各アカウントは同時に最大 60 件のタスクを実行できます。引き上げが必要な場合は support@mlmux.com までメールでお問い合わせください。