LlamaGen 로고

Nano Banana 2.1 워크플로

Google Cloud 이미지 API로 Nano Banana 2.1 실행

로컬 스크립트로 Google Cloud에 직접 요청할 수 있습니다. 인증, 모델 선택, 이미지 설정, 결과 처리를 명확하게 관리해 이미지 응답 실패가 조용히 성공 내보내기로 처리되지 않도록 하세요.

만들게 될 결과물

직접 SDK 요청과 본인이 관리하는 Google Cloud 프로젝트용 검토 체크리스트입니다. 공개 LlamaGen API 접근이 아닙니다.

Nano Banana 2.1로 만들기

Nano Banana 2.1는 유료 LlamaGen 플랜이 필요합니다. 생성 전에 현재 크레딧 소모량과 내보내기 옵션을 확인하세요. Google Cloud API 직접 사용 요금은 별도입니다. 플랜 및 크레딧

일상적인 크리에이티브 환경에서 보여주는 완성형 AI 시각물입니다.
AI 프레젠테이션 콘셉트: 실제 사용 장면에서 보여주는 완성 시각물입니다. 이 장면은 아래의 직접 모델 출력과는 별개입니다.

히어로 이미지는 완성 결과를 실제 맥락에서 보여주는 AI 생성 프레젠테이션 콘셉트입니다. 고객 사진, 앱 스크린샷, 또는 모델 성능을 별도로 검증한 결과가 아닙니다.

LlamaGen 에디토리얼 자료

콘텐츠 검토 완료:

생성 예시 확인하기

아래 예시는 문서화된 생성 워크플로에서 나온 직접 모델 출력입니다. 모델이 모든 지시를 따랐다고 가정하지 말고 실제 이미지를 확인하세요.

생성 워크플로에서 사용된 참고 이미지

이 이미지는 자체 보유한 가상 참고 에셋입니다. 포함되었다고 해서 결과물의 인물 동일성이나 제품 디테일이 정확히 보장되는 것은 아닙니다.

이 페이지에서 설명하는 워크플로에 대한 Nano Banana 2.1 직접 이미지 생성 결과입니다.
문서화된 워크플로에서 생성한 Nano Banana 2.1 직접 출력입니다. 이 가이드에 적힌 확인 항목에 따라 이미지를 검토하세요.

본인 Google Cloud 접근 준비하기

Google의 최신 문서에서는 이 플랫폼을 Gemini Enterprise Agent Platform이라고 부릅니다. 많은 개발자는 아직 이전 이름인 Vertex AI로 검색합니다. 여기 예시는 로컬 생성 워크플로에 설치된 버전인 @google/genai 1.45.0을 따르며, vertexai: true를 사용합니다. 최신 SDK에서는 옵션명이 바뀔 수 있으니, 설치한 버전의 문서를 따르세요.

결제가 설정되어 있고 필요한 서비스가 활성화되며, 요청에 사용할 자격 증명이 승인된 프로젝트를 사용하세요. 서비스 계정 파일과 액세스 토큰은 소스 코드, 페이지 콘텐츠, 이미지 프롬프트와 분리해서 보관하세요. Cloud API 요금은 LlamaGen 플랜과 별도입니다.

  • 정확한 모델 ID gemini-nano-banana-2.1을 사용하세요.
  • 이 모델에 문서화된 global 위치를 사용하세요.
  • 환경에 맞는 Google의 인증 및 프로젝트 설정 안내를 따르세요.

이 엔드포인트가 지원하는 설정 보내기

이 Cloud 모델의 문서화된 출력 크기는 1K, 2K, 4K입니다. 현재 Cloud 모델 페이지에는 프롬프트당 최대 14장의 입력 이미지와 인라인 이미지 데이터의 파일당 7 MB 제한이 명시되어 있으며, Cloud Storage 입력은 다른 제한이 적용됩니다. 이는 엔드포인트별 제한일 뿐, 모든 조합이 좋은 크리에이티브 브리프가 된다는 뜻은 아닙니다.

Cloud 문서에는 Nano Banana 2.1에서 seed, temperature, topP, topK, logprobs가 지원되지 않는다고 명시되어 있습니다. 텍스트 생성 예시의 설정을 그대로 가져오거나, seed를 이 모델의 재현성 제어값으로 설명하지 마세요.

  • 프롬프트와 작고 관련성 높은 참고 이미지 세트는 쉽게 확인할 수 있게 유지하세요.
  • 실제 입력 바이트와 일치하는 MIME 유형을 사용하세요.
  • 모델, 출력 설정, 참고 이미지 해시를 결과와 함께 기록하세요.

실제 이미지가 반환됐는지 확인하세요

출력 파일을 쓰기 전에 응답 항목에 인라인 이미지 데이터가 있는지 확인하세요. 텍스트 응답, 필터링된 결과, 이미지가 없는 응답은 완료된 생성으로 보지 말고 확인해야 할 결과로 처리하세요.

무작정 다시 시도하지 마세요. 민감하지 않은 요청 메타데이터와 응답 상태를 저장하고, 문서에 명시된 한도를 확인한 뒤 반환된 사유를 살펴보세요. 원인이 불분명한 실패 후 다시 시도하기 전에 공급업체의 현재 과금 방식을 먼저 확인하세요.

  • 자격 증명이나 비공개 입력 이미지 전체를 로그에 남기지 마세요.
  • 파일 확장자를 정할 때 반환된 이미지 MIME 유형을 그대로 반영하세요.
  • 반환된 이미지는 시각 검토가 필요한 후보로 보세요.

변수들을 분리해서 보세요

이 체크 항목은 직접 Google Cloud 경로를 설명할 뿐입니다. API 접근 권한을 제공하지 않으며, Google의 최신 설정 문서를 대체하지도 않습니다.

요청 항목사용 또는 확인가정하지 말 것
인증본인이 승인받은 Google Cloud 프로젝트와 자격 증명LlamaGen 구독만으로 Cloud API 요청이 인증된다고 보는 것
모델 및 위치global의 gemini-nano-banana-2.1비슷한 모델 별칭이 같은 모델을 선택한다고 보는 것
이미지 설정지원되는 가로세로 비율, 출력 크기, 참고 이미지 형식seed나 텍스트 모델 샘플링 파라미터가 지원된다고 보는 것
응답실제 이미지 바이트, MIME 유형, 검토 가능한 결과성공한 HTTP 응답마다 게시 가능한 이미지가 포함된다고 보는 것

실용적인 워크플로

작은 요청에서 검토 가능한 파일까지

간단한 원본 이미지 요청 하나로 시작하세요. 아래 예시는 로컬 생성 워크플로에서 사용하는 직접 SDK 구조를 따릅니다. 프로젝트 환경은 본인 환경으로 바꾸고, 승인된 설정으로 인증하세요.

수정해서 쓸 시작 프롬프트

비 오는 거리에서 랜턴을 든 오리지널 일러스트 택배원을 만들어 주세요. 실루엣이 분명하고 장면이 읽히게 구성하세요. 텍스트나 로고는 넣지 마세요.

이 브리프는 결과물을 그대로 재현하기 위한 요청 로그가 아니라, 상황에 맞게 바꿔 쓸 수 있는 레시피입니다. 동일한 결과나 첫 시도 성공을 보장하지 않습니다. 생성 기록에는 원본 요청이 그대로 보존됩니다.

워크플로 사용해 보기

  1. 자격 증명과 프로젝트는 소스 파일 밖에서 준비하세요.
  2. 지원되는 이미지 설정으로 작은 요청을 실행하세요.
  3. 반환된 이미지 항목을 확인하고, 올바른 MIME 유형으로 저장한 뒤 실제 파일을 검토하세요.

확인할 항목

  • 이미지 항목이 실제로 반환됐나요?
  • 저장한 파일이 정상적으로 열리나요?
  • 시각 결과가 브리프와 충분히 맞아 유지할 수 있나요?

직접 Google Cloud SDK 예시

이 예시는 본인 프로젝트와 자격 증명을 사용하는 직접 Google Cloud 요청입니다. 공개 LlamaGen API 엔드포인트가 아닙니다. 비공개 키를 프롬프트나 공개 페이지에 붙여 넣지 마세요.

import { GoogleGenAI } from "@google/genai";
import { writeFile } from "node:fs/promises";

// @google/genai 1.45.0, matching the documented local workflow.
// Authenticate outside this file using Google Cloud credentials.
const ai = new GoogleGenAI({
  vertexai: true,
  project: process.env.GOOGLE_CLOUD_PROJECT,
  location: "global",
  httpOptions: { apiVersion: "v1" },
});
const response = await ai.models.generateContent({
  model: "gemini-nano-banana-2.1",
  contents: [{ role: "user", parts: [{
    text: "Create an original illustrated courier carrying a lantern in a rainy street. No text or logos.",
  }] }],
  config: {
    responseModalities: ["IMAGE"],
    candidateCount: 1,
    imageConfig: { aspectRatio: "3:2", imageSize: "2K" },
    thinkingConfig: { thinkingLevel: "HIGH" },
  },
});
const image = response.candidates?.[0]?.content?.parts?.find(
  (part) => part.inlineData?.data,
)?.inlineData;
if (!image?.data) throw new Error("No image returned; inspect the response before retrying.");
const extensions = { "image/png": "png", "image/jpeg": "jpg", "image/webp": "webp" };
const extension = extensions[image.mimeType];
if (!extension) throw new Error("Inspect the returned MIME type before saving.");
await writeFile(`nano-banana-2-1.${extension}`, Buffer.from(image.data, "base64"));

시작 전 확인 질문

이것이 공개 LlamaGen API인가요?

아니요. 이 코드는 Google의 SDK를 사용해 본인의 프로젝트와 인증 정보로 Google Cloud를 직접 호출합니다. LlamaGen 모델 페이지는 별도의 제품 항목입니다.

seed(시드)나 temperature를 설정할 수 있나요?

현재 Cloud 모델 문서에 따르면 Nano Banana 2.1에서는 seed, temperature, topP, topK, logprobs를 지원하지 않습니다. 요청 파라미터를 추가하기 전에 해당 엔드포인트 문서를 확인하세요.

이미지가 없는 응답이 오면 바로 다시 시도해야 하나요?

먼저 응답과 현재 제공업체 안내를 확인하세요. 필터, 제한, 일시적 오류 때문에 결과가 달라질 수 있습니다. 이 가이드는 재시도가 성공하거나 무료라고 보장하지 않습니다.