유료 클라우드 프로젝트가 없어도 Nano Banana 2 를 체험할 수 있습니다. AI Studio 의 무료 티어면 UI 테스트와 첫 API 이미지 생성에 충분하지만, 프로덕션 연동 전 제한 사항을 꼭 확인하세요.

UI 경로 (2 분 소요)

Google AI Studio 를 열고 로그인합니다.
모델 선택기 → Gemini 3.1 Flash Image (Nano Banana 2 패밀리).
프롬프트: Product photo of a stainless water bottle on white, soft shadow, 4:5.
다운로드하거나 후속 편집으로 반복합니다.

속도 제한을 주의하세요: 무료 티어는 버스트 트래픽을 제한하며, 배치 작업은 결제가 필요한 Vertex 에서 수행해야 합니다.

API 경로 (개발자용)

AI Studio → API 키 얻기 (Git 에 커밋하지 마세요).
현재 문서의 이미지 지원 Gemini 모델 ID 를 사용하세요 (예: gemini-3.1-flash-image-preview—배포 전 Studio 에서 확인).
텍스트 프롬프트로 멀티모달 generateContent 를 전송하세요.

의사 코드 흐름:

# Store key in env — never in repo
export GEMINI_API_KEY="your-key"

앱은 환경 변수에서 키를 읽고, 프롬프트나 설정에서 종횡비를 설정하며, 바이너리 이미지 바이트를 디스크에 저장해야 합니다.

Explore Nano Banana Workflows

UI 에서 API 로 전달되는 프롬프트 팁

신뢰성을 위해 요청당 하나의 장면만 포함하세요.
텍스트 리터럴은 따옴표로 묶으세요.
SDK 에 별도 설정이 없다면 자연어로 종횡비를 요청하세요.

보안

키는 .env.local 에만 저장하고 유출 시 회전시키세요. MidassAI 사이트 빌드에는 키를 포함해서는 안 됩니다. 이 튜토리얼은 로컬 도구용입니다.

다음 단계

첫 호출이 성공하면 CMS 나 MidassAI Nano 워크플로우에 프롬프트를 래핑하여 마케터가 curl 을 직접 쓰지 않도록 하세요.

사전 요구 사항 및 설정

진행하려면 AI Studio 접근 권한이 활성화된 Google 계정이 필요합니다. 테스트에는 일반 소비자 계정으로 작동하지만, 조직 정책에 따라 외부 API 키 생성이 차단될 수 있습니다.

로컬 머신에서 환경 변수를 안전하게 관리하려면 VS Code 와 같은 코드 에디터가 설치되어 있어야 합니다. 통합 전 API 응답을 확인하려면 curl 명령을 실행할 수 있는 터미널이 도움이 됩니다.

베타 기간 동안 모델 식별자는 gemini-3.1-flash-image-preview로 유지된다고 가정합니다. Google 은 엔드포인트 이름을 자주 업데이트하므로 매주 모델 선택기에서 변경 사항을 확인하세요.

생성을 자동화하려면 최신 Python SDK 를 설치하거나 직접 호출을 위한 HTTP 클라이언트를 준비하세요. 이미지 생성 작업에는 더 이상 지원되지 않는 v1 엔드포인트에 의존하지 마세요.

확장 프롬프트 워크플로우

텍스트 문자열에 조명 조건을 명시적으로 정의하세요. "soft shadow" 같은 모호한 용어 대신 key light at 45 degrees, fill ratio 1:2처럼 지정하여 생성 간 편차를 줄입니다.
자연어로 해상도 제약 조건을 설정하세요. 이 모델 버전에 API 설정의 명시적 크기 필드가 없다면 프롬프트 내에 output resolution 1024x1024라고 작성하세요.
아티팩트를 정리하기 위해 부정적 제약 조건을 포함하세요. 후처리가 필요한 일반적인 렌더링 오류를 방지하기 위해 no text overlays, no watermarks, clean background를 추가하세요.
시드를 사용하여 변형 요청을 체이닝하세요. 수동 개입 없이 프로그래밍 방식으로 최적의 구도를 선택하기 위해 서로 다른 시드 값으로 동일한 프롬프트 5 개를 전송하세요.
출력 형식을 엄격하게 검증하세요. 빈 응답으로 스크립트가 충돌하는 것을 방지하기 위해 디코딩 전에 base64 이미지 문자열이 포함된 inlineData 응답 JSON 을 확인하세요.

일반적인 실수

스크립트에 자격 증명을 하드코딩: 개발자는 속도를 위해 소스 파일에 키를 직접 붙여넣곤 합니다. .env 파일을 사용하고 python-dotenv 같은 라이브러리로 로드하여 비밀 정보를 버전 관리 시스템에서 영구적으로 제외하세요.
속도 제한 헤더 무시: 무료 티어는 테스트 중 임계값에 도달하면 요청을 자동으로 거부합니다. 서버로부터 429 상태 코드를 받을 때 재시도 메커니즘에 지수 백오프 로직을 구현하여 수정하세요.
단일 프롬프트 과부하: 한 번에 여러 피사체가 있는 복잡한 장면을 요청하면 자주 실패합니다. 복잡한 이미지를 별도의 생성 호출로 나누고 표준 이미지 편집 도구로 나중에 합성하여 수정하세요.

MidassAI 에서 시도해 보세요

raw API 키를 처리하지 않고 관리된 환경을 원하시면 MidassAI 인터페이스를 직접 사용하세요. Nano Banana 2 기능을 시각적 워크플로우 빌더로 래핑하여 boilerplate 코드 작성이나 보안 자격 증명 관리 없이 프롬프트를 테스트하고 반복 사항을 저장할 수 있습니다.

https://www.midassai.com/studio/nano/ 에서 이미지 생성 파이프라인 구축을 시작하여 프로덕션 배포를 간소화하고 기존 마케팅 도구와 통합하세요.

AI Studio 에서 Nano Banana 2 로 첫 API 이미지 생성하기