Image 제공: Google

Nano Banana 2 API

Google의 Nano Banana 2를 하나의 통합 API로 사용해 이미지를 생성하고 편집하세요. 단일 REST 엔드포인트, 비동기 작업, 웹훅을 갖추었으며 Google Cloud 설정이 필요 없습니다.

Nano Banana 2을(를) 단 한 번의 API 호출로 통합하세요. 하나의 키, 하나의 통합 엔드포인트, 그리고 Apiframe의 모든 모델에 적용되는 통합 청구.

API 키 받기 Apiframe Studio에서 사용 Nano Banana 2 API 문서 보기

model: "nano-banana-2"

Nano Banana 2 scene of five named characters together at a dinner table, each keeping a consistent look

Nano Banana 2의 특별한 점

Flash 속도로 Pro 품질

Gemini 3.1 Flash를 기반으로 Nano Banana Pro의 추론·세계 지식·시각적 충실도를 더 빠르고 저렴한 패키지로 제공하며, 기존 Nano Banana를 대체했습니다.

Pro보다 빠르고 저렴

약 4~6초 만에 생성하며 이미지당 비용은 Nano Banana Pro의 약 절반으로, 대량·반복 작업에 적합합니다.

최대 4K 출력

512px부터 4096px까지, 14가지 화면 비율을 지원해 소셜 게시물부터 인쇄물까지 폭넓게 다룹니다.

검색 그라운딩과 세계 지식

Gemini의 지식 베이스와 실시간 웹 검색을 활용해 특정 피사체를 정확히 렌더링하며, 인포그래픽, 메모-도식 변환, 데이터 시각화에 뛰어납니다.

강력한 다중 피사체 일관성

일련의 이미지에서 여러 캐릭터와 오브젝트의 일관성을 유지하고, 정확한 다국어 텍스트 렌더링과 번역도 지원합니다.

유연한 추론과 출처

최소 또는 높은 추론 수준을 선택할 수 있으며, 모든 출력에 보이지 않는 SynthID 워터마크와 C2PA Content Credentials가 포함됩니다.

Nano Banana 2(으)로 제작

Apiframe의 Nano Banana 2 API로 생성한 출력 예시입니다.

Nano Banana 2 data visualization of global coffee consumption by country with clean labels and a legend — A data visualization of global coffee consumption by country, clean labels and legend.

Nano Banana 2 4K product photo of a sneaker on concrete in soft daylight with sharp detail — A 4K product photo of a sneaker on concrete, soft daylight, sharp detail.

Nano Banana 2 converting handwritten meeting notes into a clean flowchart diagram — Turn these handwritten meeting notes into a clean flowchart diagram.

Nano Banana 2 greeting card reading 'Congratulations' in elegant script with a watercolor floral border — A greeting card reading 'Congratulations' in elegant script with a watercolor floral border.

Nano Banana 2 scene of five characters together at a dinner table, each keeping their consistent look — Show these five characters together at a dinner table, each keeping their consistent look.

Nano Banana 2 bilingual menu board with dishes in English and Spanish, legible prices, and a modern layout — A bilingual menu board with dishes in English and Spanish, legible prices, modern layout.

개요

엔드포인트: POST /v2/images/generate
모델 ID: nano-banana-2
파라미터 키: nanoBananaParams
모달리티: 이미지
제공업체: Google
평균 완료 시간: ~12s

기능

화면 비율1:1, 3:4, 4:3, 9:16, 16:9

해상도1K, 2K, 4K

이미지 입력지원

평균 시간~12초

빠른 시작

API 키와 함께 POST /v2/images/generate 요청을 한 번 보내면 Nano Banana 2로 생성이 시작됩니다. 응답으로 폴링하거나 웹훅으로 받을 수 있는 jobId가 반환됩니다.

curl -X POST https://api.apiframe.ai/v2/images/generate \
  -H "X-API-Key: afk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
        "prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
        "model": "nano-banana-2",
        "nanoBananaParams": {
            "resolution": "1K",
            "image_input": "https://example.com/input.jpg",
            "output_format": "jpg",
            "google_search": false
        }
    }'

import requests

response = requests.post(
    "https://api.apiframe.ai/v2/images/generate",
    headers={
        "X-API-Key": "afk_your_api_key_here",
        "Content-Type": "application/json",
    },
    json={
        "prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
        "model": "nano-banana-2",
        "nanoBananaParams": {
            "resolution": "1K",
            "image_input": "https://example.com/input.jpg",
            "output_format": "jpg",
            "google_search": False
        }
    },
)
print(response.json())  # { "jobId": "...", "status": "QUEUED" }

const response = await fetch("https://api.apiframe.ai/v2/images/generate", {
  method: "POST",
  headers: {
    "X-API-Key": "afk_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
    "model": "nano-banana-2",
    "nanoBananaParams": {
      "resolution": "1K",
      "image_input": "https://example.com/input.jpg",
      "output_format": "jpg",
      "google_search": false
    }
  }),
});
const { jobId } = await response.json();
console.log(jobId);

응답 및 작업 수명 주기

생성은 비동기로 처리됩니다. 제출이 성공하면 202 Accepted와 jobId가 반환됩니다. 상태가 COMPLETED가 될 때까지 GET /v2/jobs/{id}를 폴링하거나 webhook_url을 지정하면 result 필드에 출력 URL이 담깁니다.

1. 제출 응답 (202)

{
  "jobId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
  "status": "QUEUED"
}

2. 결과 폴링

curl https://api.apiframe.ai/v2/jobs/JOB_ID \
  -H "X-API-Key: afk_your_api_key_here"

import requests, time

while True:
    job = requests.get(
        "https://api.apiframe.ai/v2/jobs/JOB_ID",
        headers={"X-API-Key": "afk_your_api_key_here"},
    ).json()
    if job["status"] in ("COMPLETED", "FAILED"):
        break
    time.sleep(2)
print(job["result"])

let job;
do {
  await new Promise((r) => setTimeout(r, 2000));
  job = await fetch("https://api.apiframe.ai/v2/jobs/JOB_ID", {
    headers: { "X-API-Key": "afk_your_api_key_here" },
  }).then((r) => r.json());
} while (job.status !== "COMPLETED" && job.status !== "FAILED");
console.log(job.result);

입력 스키마

Nano Banana 2 엔드포인트가 허용하는 요청 파라미터입니다. 모델별 옵션은 아래에 표시된 파라미터 객체 안에 중첩됩니다.

파라미터	유형	필수	기본값	허용값 / 범위	설명
prompt	string	필수	—	—	생성할 내용에 대한 텍스트 설명.
model	string	필수	"nano-banana-2"	"nano-banana-2"	이 엔드포인트의 모델 식별자.
nanoBananaParams.resolution	string	선택	"1K"	"512px", "1K", "2K", "4K"	Resolution
nanoBananaParams.image_input	string (URL)	선택	—	—	Compose with or edit a reference image.
nanoBananaParams.output_format	string	선택	"jpg"	"jpg", "png", "webp"	Output format
nanoBananaParams.google_search	boolean	선택	false	—	Google search grounding
nanoBananaParams.image_search	boolean	선택	false	—	Image search grounding

자주 묻는 질문

Nano Banana 2 API에 대한 일반적인 질문입니다.

Nano Banana 2는 무엇인가요?

Google의 Gemini 3.1 Flash Image로, 2026년 2월에 출시되어 Flash 속도로 Pro 수준의 품질을 제공하며 기존 Nano Banana를 대체했습니다.

Nano Banana Pro와 어떻게 다른가요?

품질은 비슷하면서 약 4배 빠르고 비용은 약 절반입니다. Pro는 가장 까다로운 텍스트와 브랜딩 작업에 적합한 선택지로 남아 있습니다.

어떤 해상도로 생성되나요?

최대 4K로, 512px~4096px와 14가지 화면 비율을 지원합니다.

얼마나 빠르고 저렴한가요?

이미지당 약 4~6초, 약 $0.065로 Pro의 약 절반 가격입니다.

몇 개의 피사체까지 일관성을 유지하나요?

이미지 전반에서 여러 캐릭터와 오브젝트를 유지하며, 여러 캐릭터와 다수의 오브젝트를 동시에 일관되게 유지할 수 있습니다.

어디에서 사용할 수 있나요?

Apiframe는 물론 Gemini 앱, Google AI Studio, Gemini API, Vertex AI를 통해 사용할 수 있습니다.

아직 궁금한 점이 있으신가요?

고객 지원 문의 Discord 참여

Nano Banana 2 API로 개발을 시작하세요

API 키를 받아 몇 분 만에 Nano Banana 2을(를) 통합하세요 — 사용한 만큼 지불.

무료 크레딧으로 시작

모든 모델을 위한 하나의 API

웹훅, SDK 및 멱등성

제공업체 계정 불필요

무료로 시작하기 문서 읽기

궁금하신 점이 있으신가요? Discord에 참여하거나 영업팀에 문의하세요.