Nano Banana 2 APIの使い方：画像の生成と編集

"""Nano Banana 2（gemini-3.1-flash-image）で画像を生成または編集する。"""
import argparse
import base64
import os
import sys
from pathlib import Path

import requests

URL = "https://api.laozhang.ai/v1beta/models/gemini-3.1-flash-image:generateContent"
RATIOS = ["1:1", "1:4", "1:8", "2:3", "3:2", "3:4", "4:1", "4:3", "4:5", "5:4", "8:1", "9:16", "16:9", "21:9"]
SIZES = ["512", "1K", "2K", "4K"]
MIME_TYPES = {".png": "image/png", ".jpg": "image/jpeg", ".jpeg": "image/jpeg", ".webp": "image/webp"}
EXTENSIONS = {"image/png": "png", "image/jpeg": "jpg", "image/webp": "webp"}

parser = argparse.ArgumentParser(description="画像を生成する。画像ファイルを渡した場合はそれを編集する。")
parser.add_argument("prompt")
parser.add_argument("images", nargs="*", help="参照画像（PNG、JPEG、WebP、最大14枚）")
parser.add_argument("--ratio", choices=RATIOS, help="アスペクト比。省略すると1:1、または入力画像に合わせる")
parser.add_argument("--size", default="1K", choices=SIZES)
parser.add_argument("--out", default="nano-banana-2", help="拡張子を除いた出力ファイル名")
args = parser.parse_args()
if len(args.images) > 14:
    sys.exit("参照画像は最大14枚までです。")

parts = [{"text": args.prompt}]
for path in args.images:
    mime = MIME_TYPES.get(Path(path).suffix.lower())
    if mime is None:
        sys.exit(f"PNG、JPEG、WebPのいずれかのファイルを指定してください: {path}")
    data = base64.b64encode(Path(path).read_bytes()).decode("ascii")
    parts.append({"inlineData": {"mimeType": mime, "data": data}})

image_config = {"imageSize": args.size}
if args.ratio:
    image_config["aspectRatio"] = args.ratio

response = requests.post(
    URL,
    headers={"Authorization": f"Bearer {os.environ['LAOZHANG_API_KEY']}"},
    json={
        "contents": [{"role": "user", "parts": parts}],
        "generationConfig": {"responseModalities": ["IMAGE"], "imageConfig": image_config},
    },
    timeout=300,
)
if response.status_code != 200:
    sys.exit(f"HTTP {response.status_code}: {response.text[:500]}")

result = response.json()
images = [
    part["inlineData"]
    for candidate in result.get("candidates") or []
    for part in (candidate.get("content") or {}).get("parts") or []
    if "inlineData" in part and not part.get("thought")
]
if not images:
    reasons = [candidate.get("finishReason") for candidate in result.get("candidates") or []]
    sys.exit(f"画像が返されませんでした: {result.get('promptFeedback') or reasons}")
for number, image in enumerate(images, start=1):
    suffix = "" if number == 1 else f"-{number}"
    output = Path(f"{args.out}{suffix}.{EXTENSIONS.get(image['mimeType'], 'bin')}")
    output.write_bytes(base64.b64decode(image["data"]))
    print("保存しました", output)

python nano_banana_2.py "Generate an image of a night market food stall with a hand-painted sign that reads \"NOODLES\", warm lantern light." --ratio 16:9 --size 4K --out nb2-night-market

# 画像を1枚編集する
python nano_banana_2.py "この昼間の街の写真を、ネオンが映り込む雨の夜の風景に変えてください。建物はそのままにしてください。" street.jpg --ratio 3:2 --size 2K --out nb2-street

# 3枚の参照画像を組み合わせる：商品、シーン、雰囲気を決める3枚目の画像
python nano_banana_2.py "1枚目の画像の商品を2枚目の画像のテーブルの上に置き、3枚目の画像のスタイルで描いてください。" product.png scene.jpg style.jpg --ratio 3:2 --size 2K --out nb2-composite