Nano Banana API 이미지 편집 사용법(Standard)

"""Nano Banana Standard(gemini-2.5-flash-image)로 이미지를 편집하거나 합성합니다."""
import argparse
import base64
import os
import sys
from pathlib import Path

from openai import OpenAI

from nano_banana_save import save_images

MIME_TYPES = {".png": "image/png", ".jpg": "image/jpeg", ".jpeg": "image/jpeg", ".webp": "image/webp"}

parser = argparse.ArgumentParser(description="이미지 한 장을 편집하거나, 최대 세 장을 합성합니다.")
parser.add_argument("prompt", help="편집 지시문")
parser.add_argument("images", nargs="+", help="로컬 PNG, JPEG, WebP 파일 또는 공개 HTTPS URL")
parser.add_argument("--out", default="nano-banana-edit", help="확장자를 뺀 출력 파일 이름")
args = parser.parse_args()
if len(args.images) > 3:
    sys.exit("gemini-2.5-flash-image는 입력 이미지가 최대 3장일 때 가장 잘 동작합니다.")

content = [{"type": "text", "text": args.prompt}]
for source in args.images:
    if source.startswith("https://"):
        url = source  # 공개 이미지 URL은 그대로 보냅니다
    else:
        mime = MIME_TYPES.get(Path(source).suffix.lower())
        if mime is None:
            sys.exit(f"PNG, JPEG, WebP 파일을 사용하세요: {source}")
        url = f"data:{mime};base64," + base64.b64encode(Path(source).read_bytes()).decode("ascii")
    content.append({"type": "image_url", "image_url": {"url": url}})

# max_retries=0: 타임아웃 뒤 자동 재시도하면 이미지가 두 번 생성되어 두 번 과금될 수 있습니다
client = OpenAI(api_key=os.environ["LAOZHANG_API_KEY"], base_url="https://api.laozhang.ai/v1", timeout=300, max_retries=0)
reply = client.chat.completions.create(
    model="gemini-2.5-flash-image",
    messages=[{"role": "user", "content": content}],
)
for path in save_images(reply.model_dump(), args.out):
    print("저장됨:", path)

python nano_banana_edit.py "배경을 밝은 회색 단색 스튜디오 벽으로 바꿔 주세요. 제품, 라벨, 그림자는 그대로 유지하세요." product.jpg --out product-studio

base64 < street.jpg | tr -d '\n' > street.b64
jq -n --rawfile image street.b64 '{
  contents: [{
    role: "user",
    parts: [
      {text: "이 낮 거리 사진을 네온이 비치는 비 오는 밤 장면으로 바꿔 주세요. 건물은 그대로 유지하세요."},
      {inlineData: {mimeType: "image/jpeg", data: $image}}
    ]
  }],
  generationConfig: {
    responseModalities: ["IMAGE"],
    imageConfig: {aspectRatio: "16:9"}
  }
}' > native-edit-request.json

curl --fail-with-body --max-time 300 \
  "https://api.laozhang.ai/v1beta/models/gemini-2.5-flash-image:generateContent" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @native-edit-request.json \
  -o native-edit-response.json

python nano_banana_save.py native-edit-response.json street-night