Nano Banana 2 Lite API: generate and edit

"""Generate or edit 1K images with Nano Banana 2 Lite (gemini-3.1-flash-lite-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-lite-image:generateContent"
RATIOS = ["1:1", "2:3", "3:2", "3:4", "4:3", "4:5", "5:4", "9:16", "16:9", "21:9"]
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="Generate an image, or edit the images you pass.")
parser.add_argument("prompt")
parser.add_argument("images", nargs="*", help="up to 14 PNG, JPEG, or WebP images")
parser.add_argument("--ratio", choices=RATIOS, help="aspect ratio; omit for 1:1, or to follow an input image")
parser.add_argument("--out", default="nano-banana-lite", help="output file name without extension")
args = parser.parse_args()
if len(args.images) > 14:
    sys.exit("Send at most 14 images.")

parts = [{"text": args.prompt}]
for path in args.images:
    mime = MIME_TYPES.get(Path(path).suffix.lower())
    if mime is None:
        sys.exit(f"Use a PNG, JPEG, or WebP file: {path}")
    data = base64.b64encode(Path(path).read_bytes()).decode("ascii")
    parts.append({"inlineData": {"mimeType": mime, "data": data}})

image_config = {"imageSize": "1K"}
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"No image returned: {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("Saved", output)

python nano_banana_lite.py "Generate an image of a modern logistics dashboard on a dark gray background with cyan highlights." --ratio 16:9 --out lite-dashboard

python nano_banana_lite.py "Keep the product unchanged and replace the background with a light-gray studio wall." product.jpg --ratio 4:5 --out lite-product