이런 상황, 다들 한번쯤은 겪어봤죠? 제품 사진이 수십, 수백 장씩 쌓여 있는데, 가격이나 프로모션 문구 몇 글자만 바꾸라고 포토샵을 계속 열어야 할 때. 글자 레이어 찾아서 살살 바꾸고, 또 이름 바꿔서 저장하고... 스무 장만 바꿔도 눈 튀어나오고 머리 깨질 것 같잖아요. 시간 오래 걸리는 건 당연하고, 힘든 건 둘째치고 실수하기 딱 좋은 상황이죠. 그래서 한두 장씩 빼먹는 거죠, 뭐.

예전엔 보통 이렇게 했었을 거예요:

일단 포토샵 켜고...
사진 불러오고...
글자 레이어 찾아서...
글자 바꾸고...
이미지 저장 또는 내보내고...
이걸 엄청 반복하는 거고요.

수십, 수백 장의 사진을 앞에 두고 상상만 해도 정말 끔찍한 단순 작업이죠.

근데 이제는 이렇게 할 수 있어요:

파이썬 스크립트 실행하기.
이제 커피 한잔하면서 휴대폰이나 좀 만지작 거리고 있으면...
짠! 다 돌아와서 보면 모든 사진이 다 수정돼서 폴더 쏙- 들어가 있어요.

이 모든 걸 가능하게 해주는 마법의 주인공, 바로 제가 오늘 알려드릴 AI 이미지 편집 기능이랍니다.

여기서 핵심은 Nano Banana API예요

쉽게 말해서, Nano Banana API는 간단한 글자 설명만 가지고도 이미지 안의 내용을 직접 고칠 수 있는 정말 강력한 AI 도구랄까요? 디자이너한테 말로 시키는 것처럼 쉽다고 할 수 있죠.

"사진 속 '¥19.9'를 '¥9.9'로 바꿔줘" 이렇게 말만 해주면, AI가 알아서 다 이해하고 수정해준답니다.

준비물? 3단계면 충분해요, 아주 간단하게!

걱정 마세요. 준비하는 거 정말 간단해서 3분이면 족하답니다.

Python 설치: 일단 컴퓨터에 파이썬 3가 설치되어 있는지부터 확인해볼까요?
라이브러리 설치: 네트워크 요청을 보낼 requests 라이브러리 하나만 있으면 돼요. 터미널 열고 아래 명령어만 치면 됩니다.
```
pip install requests
```
API 키 발급받기: API 제공 사이트에 가입해서 API Key를 받아오세요. 이게 서비스 쓸 수 있는 유일한 열쇠랍니다.

자, 이제 준비 끝! 엄청 쉽죠?

바로 써먹는 실전 코드 전체 공개!

여기 완전한 파이썬 스크립트를 바로 올려드릴게요. YOUR_API_KEY라고 써 있는 부분만 본인 키로 바꾸고, 이미지 주소랑 설명(프롬프트)만 살짝 수정하면 바로 돌려볼 수 있어요.

코드 안에다가 API 어떻게 쓰는지 자세히 설명하는 주석도 다 달아뒀어요.

import requests
import time
import json

# --- 1. 준비 단계: 본인의 API 키와 주소 설정 ---
# 여기에 본인의 API 키를 넣어주세요
API_KEY = "YOUR_API_KEY" 
# 문서에 나온 API 기본 주소입니다
BASE_URL = "https://api.defapi.org" 
# 인증을 위해 필요한 요청 헤더입니다. "Bearer <your-api-key>" 형식을 따라요
headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

def edit_image_with_text(image_url: str, prompt: str):
    """
    Nano Banana API를 써서 텍스트 프롬프트에 따라 이미지를 수정해주는 함수입니다.
    
    :param image_url: 고치고 싶은 이미지의 URL 주소
    :param prompt: 수정 지시문. 예시: "이미지의 가격 텍스트를 99원으로 바꿔줘"
    :return: 수정된 이미지의 URL 주소, 실패하면 None을 반환합니다
    """
    print(f"🚀 이미지 처리 시작: {image_url}")
    print(f"📝 수정 지시문: {prompt}")

    # --- 2. 이미지 수정 작업을 요청하는 부분 ---
    # 작업을 만드는 API 엔드포인트 주소입니다
    gen_url = f"{BASE_URL}/api/image/gen"
    
    # AI한테 뭘 할지 알려주는 요청 내용을 만듭니다
    # model: "google/nano-banana" 모델을 쓴다고 명시해요
    # prompt: 우리의 수정 지시문
    # images: 원본 이미지 URL (최대 4장), 여기서는 1장만 쓸게요
    payload = {
        "model": "google/nano-banana",
        "prompt": prompt,
        "images": [image_url]
    }

    try:
        # 비동기 작업을 만들기 위해 POST 요청을 보냅니다
        response = requests.post(gen_url, headers=headers, json=payload)
        response.raise_for_status()  # 요청이 실패하면 (예: 401, 400) 예외가 발생해요
        
        # 응답에서 task_id를 가져옵니다. 이걸로 작업 상태를 계속 확인할 수 있어요
        task_id = response.json().get("data", {}).get("task_id")
        if not task_id:
            print("❌ 오류: task_id를 가져오지 못했습니다.")
            return None
            
        print(f"✅ 작업 생성 성공! 작업 ID: {task_id}")

        # --- 3. 작업 결과를 계속 확인(폴링)하는 부분 ---
        # 작업 상태를 조회하는 API 엔드포인트 주소입니다
        query_url = f"{BASE_URL}/api/task/query"
        
        # 작업이 성공하거나 실패할 때까지 계속 물어봅니다
        while True:
            # task_id를 파라미터로 GET 요청을 보냅니다
            params = {"task_id": task_id}
            query_response = requests.get(query_url, headers=headers, params=params)
            query_response.raise_for_status()
            
            result_data = query_response.json().get("data", {})
            status = result_data.get("status")
            
            print(f"⏳ 지금 작업 상태: {status}...")
            
            if status == "success":
                # 작업 성공! result 필드에서 수정된 이미지 URL을 가져옵니다
                edited_image_url = result_data.get("result", [{}])[0].get("image")
                print(f"🎉 이미지 수정 완료! 새 이미지 주소: {edited_image_url}")
                return edited_image_url
            elif status == "failed":
                # 작업 실패, 실패 이유를 출력해요
                reason = result_data.get("status_reason", {}).get("message", "알 수 없는 오류")
                print(f"❌ 작업 실패: {reason}")
                return None
            else:
                # 작업이 아직 진행 중 (in_progress, pending 등), 5초 기다렸다가 다시 시도해요
                time.sleep(5)

    except requests.exceptions.RequestException as e:
        print(f"❌ 네트워크 요청 오류: {e}")
        return None
    except json.JSONDecodeError:
        print("❌ API 응답 파싱 실패. JSON 형식이 올바르지 않아요.")
        return None


if __name__ == "__main__":
    # --- 여기서 이미지 URL과 수정 지시문을 바꿔주세요 ---
    # 예제 이미지: 가격 라벨이 있는 제품 사진입니다
    target_image_url = "https://cdn.openai.com/API/docs/images/body-lotion.png"
    # 예제 지시문: 가격을 새로운 값으로 바꿔봅니다
    modification_prompt = "Change the price text on the bottle to $9.99"
    
    # 함수를 불러서 작업을 시작해요 (여기서는 예시로 1장만 처리)
    # URL 리스트를 만들어서 for문으로 감싸면 대량으로도 처리할 수 있습니다!
    final_image_url = edit_image_with_text(target_image_url, modification_prompt)
    
    if final_image_url:
        print("\n처리가 끝났습니다. 위 주소에 들어가서 결과를 확인해 보세요.")
    else:
        print("\n처리는 끝났지만, 수정된 이미지를 가져오는 데 실패했습니다.")

그럼 어떻게 쓰는 건데요?

코드 저장하기: 위 코드를 batch_edit.py 같은 이름으로 파일 하나 만들어서 저장하세요.
API 키 넣기: API_KEY = "YOUR_API_KEY" 이 줄 찾아서 YOUR_API_KEY 부분에다가 본인이 받은 키를 그대로 복사해서 붙여넣으세요.
이미지랑 지시문 바꾸기: if __name__ == "__main__": 여기 안에 있는 target_image_url이랑 modification_prompt 이 두 개만 바꿔주면 돼요.
스크립트 돌리기: 이제 터미널에서 python batch_edit.py 이렇게 입력하고 엔터 치세요.

그러면 터미널 창에 스크립트가 지금 뭘 하는지 실시간으로 뜰 거예요. 다 끝나면 알아서 멈추고요. 만약에 사진을 한꺼번에 많이 바꾸고 싶다면, 이미지 주소랑 지시문을 리스트로 만들어 놓고 edit_image_with_text 함수를 반복문으로 쭉 돌리기만 하면 돼요.

자, 이제 이 지루한 반복 작업에서 한 번에 해방됐죠? 바로 따라 해보세요

포토샵으로 그냥 글자 하나하나 바꾸고 있어? Python + Nano Banana API 쓰면 한번에 끝나요!