Nano Banana 2.1 画像編集
google/nano-banana-2.1/edit
Google 画像編集。最大 14 枚の参照画像と 1K〜4K 出力に対応し、トークン使用量で精算します。
サンプル
パラメータ
| 名前 | 型 | 既定 | 制約 | 説明 |
|---|---|---|---|---|
| images *入力画像 | image_upload | — | image/png,image/jpeg,image/webp · 1–14 items | 編集または参考用に 1〜14 枚の画像をアップロードしてください(公式上限 14 枚)。png / jpeg / webp、公開 URL または base64 data URL。 |
| prompt *プロンプト | textarea | — | ≤ 5000 chars | 画像をどのように編集したいかを説明してください:何を変え、何を残し、どんなスタイルにするか。複数の画像は「1枚目」「2枚目」のように指定できます。画像内に入れるテキストは引用符で囲んでください。 |
| aspect_ratioアスペクト比 | select | — | 1:1 | 3:2 | 2:3 | 4:3 | 3:4 | 5:4 | 4:5 | 16:9 | … | 出力画像のアスペクト比を選択してください。指定しない場合、入力画像に従います。 |
| resolution解像度 | select | 1k | 1k | 2k | 4k | 出力画像の長辺解像度を選択してください。高解像度ほど詳細になりますが、コストと処理時間が増えます。 |
| thinking_level思考レベル | select | medium | minimal | medium | high | 生成前の思考量を制御します。高いほど構図と細部が向上しますが、生成時間が長くなります。 |
| enable_web_searchウェブ検索 | boolean | false | — | プロンプトに応じた検索を許可します。有効化による固定加算はなく、このエンドポイントは報告されたトークン使用量で精算します。 |
| enable_image_search画像検索 | boolean | false | — | プロンプトに応じた検索を許可します。有効化による固定加算はなく、このエンドポイントは報告されたトークン使用量で精算します。 |
出力フィールド
| フィールド | 型 | 説明 |
|---|---|---|
| text | string | |
| images | array<string> |
API
統一 REST API でこのモデルを呼び出せます。API Keys ページでキーを取得してください。
cURL
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/google/nano-banana-2.1/edit" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"images": "https://example.com/input.jpg",
"prompt": "A cinematic portrait, dramatic rim light, shallow depth of field",
"resolution": "1k",
"thinking_level": "medium",
"enable_web_search": false,
"enable_image_search": false
}
}'
# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
-H "Authorization: Bearer YOUR_API_KEY"Python
import time, requests
API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
# 1) Submit
resp = requests.post(
"https://www.namifusion.com/api/v1/marketplace/run/google/nano-banana-2.1/edit",
headers=HEADERS,
json={
"input": {
"images": "https://example.com/input.jpg",
"prompt": "A cinematic portrait, dramatic rim light, shallow depth of field",
"resolution": "1k",
"thinking_level": "medium",
"enable_web_search": False,
"enable_image_search": False
}
},
)
resp.raise_for_status() # 401/402/429/5xx stop here instead of polling a bad task
task = resp.json()
# 2) Poll until a terminal state (completed / failed / cancelled).
# This model is allowed up to 300s server-side.
deadline = time.time() + 360
while task.get("status") not in ("completed", "failed", "cancelled"):
if time.time() > deadline:
raise TimeoutError(f"still {task.get('status')} — keep the task_uuid and poll later")
time.sleep(3)
poll = requests.get(f"https://www.namifusion.com/api/v1/marketplace/run/tasks/{task['task_uuid']}", headers=HEADERS)
poll.raise_for_status()
task = poll.json()
print(task["status"], task.get("output"))JavaScript
const API_KEY = "YOUR_API_KEY";
const HEADERS = { Authorization: `Bearer ${API_KEY}` };
// 1) Submit
const resp = await fetch("https://www.namifusion.com/api/v1/marketplace/run/google/nano-banana-2.1/edit", {
method: "POST",
headers: { ...HEADERS, "Content-Type": "application/json" },
body: JSON.stringify({
"input": {
"images": "https://example.com/input.jpg",
"prompt": "A cinematic portrait, dramatic rim light, shallow depth of field",
"resolution": "1k",
"thinking_level": "medium",
"enable_web_search": false,
"enable_image_search": false
}
}),
});
if (!resp.ok) throw new Error(`submit failed: ${resp.status} ${await resp.text()}`);
let task = await resp.json();
// 2) Poll until a terminal state (completed / failed / cancelled).
// This model is allowed up to 300s server-side.
const deadline = Date.now() + 360 * 1000;
while (!["completed", "failed", "cancelled"].includes(task.status)) {
if (Date.now() > deadline) throw new Error(`still ${task.status} — keep the task_uuid and poll later`);
await new Promise((r) => setTimeout(r, 3000));
const poll = await fetch(`https://www.namifusion.com/api/v1/marketplace/run/tasks/${task.task_uuid}`, { headers: HEADERS });
if (!poll.ok) throw new Error(`poll failed: ${poll.status}`);
task = await poll.json();
}
console.log(task.status, task.output);ドキュメント
Nano Banana 2.1 画像編集
テキスト指示と 1〜14 枚の参照画像で画像を編集します。
入力パラメータ
| パラメータ | 必須 | 型・制限・初期値 |
|---|---|---|
images | はい | array;公開画像 URL または base64 data URL、1〜14 件。PNG/JPEG/WebP 対応。 |
prompt | はい | string;最大 5,000 文字。 |
aspect_ratio | いいえ | string;省略すると入力画像に従います。 1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 21:9 |
resolution | いいえ | string; 1k / 2k / 4k; default: 1k. |
thinking_level | いいえ | string;minimal / medium / high;初期値 medium。 |
enable_web_search | いいえ | boolean;初期値 false。必要に応じた検索を許可し、実行するかはモデルが判断します。 |
enable_image_search | いいえ | boolean;初期値 false。必要に応じた検索を許可し、実行するかはモデルが判断します。 |
トークン料金
| 計量項目 | USD / 100万トークン | クレジット / 100万トークン |
|---|---|---|
| 入力(テキストと参照画像) | $1.50 | 150 |
| テキスト出力と思考 | $7.50 | 750 |
| 画像出力 | $30.00 | 3000 |
Google Standard のトークン単価を適用します。1 USD = 100 クレジット。参照画像は入力トークンとして課金し、枚数による固定加算はありません。このエンドポイントはトークン使用量のみで精算し、検索の有効化による固定加算はありません。
送信時は画像部分のみを仮請求します。1K / 2K / 4K はそれぞれ 3.36 / 5.04 / 11.34 クレジット。完了後、トークン料金との差額を返金または追加請求します。最終金額は 0.01 クレジット単位で切り上げ、アカウント割引は別途適用します。
API の例
画像 URL をアップロード済みの画像に置き換えてください。
POST https://www.namifusion.com/api/v1/marketplace/run/google/nano-banana-2.1/edit
Authorization: Bearer YOUR_NAMIFUSION_API_KEY
Content-Type: application/json
{
"input": {
"prompt": "Change the background to a quiet bookstore. Preserve the subject.",
"resolution": "1k",
"thinking_level": "medium",
"images": [
"https://example.com/input.png"
]
}
}
GET https://www.namifusion.com/api/v1/marketplace/run/tasks/{task_uuid}
Authorization: Bearer YOUR_NAMIFUSION_API_KEY
一度送信し、返された task_uuid で状態を確認します。完了時の output.images は画像 URL 配列です。output.text に付随するテキストが含まれる場合があります。
関連モデル
xAI Grok Imagine Image v2.0 画像編集
xAI Grok Imagine Image V2.0 Edit は、テキストによるプロンプトを使って入力画像を編集できるモデルです。解像度と品質を設定でき、精密な画像編集、ビジュアル調整、クリエイティブなバリエーション、SNS コンテンツ、マーケティング素材、制作ワークフローに適しています。すぐに使える REST 推論 API を提供し、高性能・コールドスタートなし・手頃な価格で利用できます。
qwen-image-edit-spicy
テキスト指示で画像を精密に編集。要素の追加・削除・変更、スタイル変換、背景置換に対応し、写真補正やビジュアルデザインに適しています。
Qwen Image 3.0 Pro Edit|高速画像編集
Qwen Image 3.0 Pro Edit は、優れた画質と高度な指示理解を備えたプロ向けの画像編集モデルです。最大 2k に対応。すぐに使える REST inference API を提供し、高性能、コールドスタートなし、手頃な価格で利用できます。
OpenAI GPT Image 2.5 Sunburst 画像編集
最大 16 枚の参照画像を使用し、高精細で正確な画像編集を行います。
OpenAI GPT Image 2.5 Flare 画像編集
自然言語の指示と最大 16 枚の参照画像を使用して、高速でバランスの取れた画像編集を行います。
ヘッドスワップ(画像)
namifusion/head-swap/image-edit. 画像・動画・顔交換のモデル API を閲覧。試してから統一 REST API で統合。
Nano Banana 画像編集
高速・低価格な編集。 マスキング不要で、直感的なオブジェクト置換やスタイル変換が可能。
Nano Banana Pro 画像編集
4K セマンティック編集。自然言語で画像を修正。文脈認識と画像内多言語テキスト編集に対応。