Felo API PlatformFelo API Platform
모델 목록으로 돌아가기

Nano Banana 2.1 API

Google의 Gemini 3.6 Flash 기반 이미지 생성·편집 모델로, 마스크 기반 편집과 다중 턴 대화형 워크플로를 지원합니다.

Nano Banana 2.1은 Gemini 3 시리즈에 속하는 Google의 이미지 생성 및 편집 모델로, Gemini 3.6 Flash를 기반으로 합니다. 마스크로 지정한 영역만 변경하면서 주변 구도를 유지하는 편집, 장면과 조명, 각도가 달라져도 얼굴과 정체성을 일관되게 유지하는 기능, 프롬프트당 최대 14장의 참조 이미지 활용을 지원합니다. 최대 4명의 인물과 10개의 객체에 대한 정체성 일관성도 유지합니다.

1K, 2K, 4K 이미지 해상도를 지원하며 기본값은 1K입니다. 1:1, 3:2, 2:3, 3:4, 1:4, 4:1, 4:3, 4:5, 5:4, 1:8, 8:1, 9:16, 16:9, 21:9 비율을 지원하고, 2K와 4K에서 와이드·파노라마 비율의 타일링 아티팩트를 수정했습니다. 입력 이미지는 장당 1,120 토큰을 소비하고 출력 이미지 토큰은 1K에서 1,120, 2K에서 1,680, 4K에서 3,780입니다.

전문가 수준의 정밀한 이미지 제작과 편집, 여러 차례에 걸친 빠른 반복 편집, 포스터와 복잡한 다이어그램의 선명한 텍스트 생성, 다국어 국소 텍스트 렌더링, 스토리텔링과 반복 워크플로를 위한 다중 턴 대화형 편집에 적합합니다. 제품 장면과 다인물 장면, 시리즈 자산을 위한 다중 이미지 융합, 가상 피팅과 캐릭터 생성에도 활용할 수 있습니다.

업데이트:

모델 ID

gemini-nano-banana-2.1
컨텍스트
65.536K
최대 출력
58.982K
입력
image / text
출력
image / text

주요 특징

  • Gemini 3.6 Flash 기반 이미지 생성·편집
  • 마스크 영역만 바꾸는 정밀 편집
  • 장면·조명·각도가 달라도 인물 일관성 유지
  • 프롬프트당 최대 14장 참조 이미지
  • 최대 4명 인물·10개 객체 정체성 유지
  • 1K·2K·4K 해상도 지원

제공 업체

1 제공 업체

제공 업체별 API 요금을 비교하세요. 공급자를 선택하면 전체 요금과 적용 조건을 확인할 수 있습니다.

제공 업체 · 요금 상세
가동률

추론

기본 추론 강도
minimal
기본 활성화
예
항상 활성화
아니요
선택 가능한 추론 강도
high / minimal / none

Quick Start

이미지 작업을 제출하고 상태를 조회한 뒤 이미지를 저장합니다. curl과 Python 3 표준 라이브러리만 사용합니다.

POST https://openapi.felo.ai/api/v1/images/generations

1API key 설정

Felo API Platform 계정에서 key를 만들고 환경 변수로 설정하세요.

export FELO_API_KEY="YOUR_API_KEY"

2첫 요청 보내기

선택 매개변수 값은 모델마다 달라 예제에서는 지정하지 않습니다. 추가 전에 Playground에서 확인하세요. 필드는 input 안이 아닌 model, prompt와 같은 수준에 둡니다.

curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -o created.json \
  -d '{
  "prompt": "A studio product photo of a ceramic coffee cup on warm linen, soft morning light",
  "model": "gemini-nano-banana-2.1"
}'

3작업 폴링

제출 후 task_id가 반환됩니다. queued 또는 running이면 3초마다 조회하고 succeeded, failed, interrupted이면 멈춥니다. 최대 30분 대기합니다. created.json을 보관하면 재제출 없이 같은 작업을 계속 조회할 수 있습니다.

python3 - <<'PY'
import json, os, time
from pathlib import Path
from urllib.parse import quote
from urllib.request import Request, urlopen

task = json.loads(Path("created.json").read_text())
task_id = task["task_id"]
url = "https://openapi.felo.ai/api/v1/images/generations/" + quote(task_id, safe="")
headers = {"Authorization": "Bearer " + os.environ["FELO_API_KEY"]}
deadline = time.monotonic() + 1800

while task["status"] in ("queued", "running"):
    if time.monotonic() >= deadline:
        raise TimeoutError(f"Keep task_id={task_id} to resume polling")
    time.sleep(3)
    with urlopen(Request(url, headers=headers), timeout=60) as response:
        task = json.load(response)
    if task.get("task_id") != task_id or task.get("kind") != "image":
        raise ValueError("Unexpected task response")
    print(task["status"])

if task["status"] != "succeeded":
    raise RuntimeError(task.get("error") or task["status"])
if not task.get("outputs"):
    raise ValueError("Task succeeded without image outputs")
Path("task.json").write_text(json.dumps(task))
print("Saved task.json")
PY

4출력 다운로드

성공하면 task.json의 outputs를 저장합니다. HTTPS URL, URL 객체, b64_json을 지원합니다. 서명 URL은 즉시 다운로드하세요. 이미지 다운로드에는 API Key가 필요하지 않습니다.

python3 - <<'PY'
import base64, json
from pathlib import Path
from urllib.request import urlopen

task = json.loads(Path("task.json").read_text())
if task.get("status") != "succeeded" or not task.get("outputs"):
    raise ValueError("No completed image outputs")
extensions = {"image/png": ".png", "image/jpeg": ".jpg", "image/webp": ".webp", "image/gif": ".gif", "image/avif": ".avif"}

for index, output in enumerate(task["outputs"], 1):
    item = output if isinstance(output, dict) else {}
    url = output if isinstance(output, str) else item.get("url") or item.get("unsigned_url")
    mime = item.get("media_type") or "image/png"
    if url and url.startswith("https://"):
        with urlopen(url, timeout=60) as response:
            data = response.read()
            mime = response.headers.get_content_type()
    elif url and url.startswith("data:image/") and ";base64," in url:
        header, encoded = url.split(",", 1)
        mime = header[5:].split(";", 1)[0]
        data = base64.b64decode(encoded, validate=True)
    elif item.get("b64_json"):
        data = base64.b64decode(item["b64_json"], validate=True)
    else:
        raise ValueError("Unrecognized image output")
    path = Path(f"image-{index}" + extensions.get(mime, ".bin"))
    path.write_bytes(data)
    print(path)
PY
input_references

이미지 편집 시 예제 URL을 본인의 HTTPS 이미지 URL 또는 base64 이미지 data URL로 바꾸세요. 한 번 제출한 후 동일한 조회 및 저장 단계를 따릅니다.

curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -o created.json \
  -d '{
  "prompt": "Keep the product and framing. Replace the background with a sunlit marble countertop.",
  "model": "gemini-nano-banana-2.1",
  "input_references": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/product.png"
      }
    }
  ]
}'

지원 매개변수

  • n
  • seed
  • tools
  • top_p
  • reasoning
  • max_tokens
  • resolution
  • temperature
  • tool_choice
  • aspect_ratio
  • response_format
  • input_references
  • reasoning_effort
  • include_reasoning
  • structured_outputs

전체 레퍼런스가 필요하신가요?

API 문서 →

자주 묻는 질문

모델 소개: Nano Banana 2.1?

Nano Banana 2.1은 Gemini 3 시리즈에 속하는 Google의 이미지 생성 및 편집 모델로, Gemini 3.6 Flash를 기반으로 합니다. 마스크로 지정한 영역만 변경하면서 주변 구도를 유지하는 편집, 장면과 조명, 각도가 달라져도 얼굴과 정체성을 일관되게 유지하는 기능, 프롬프트당 최대 14장의 참조 이미지 활용을 지원합니다. 최대 4명의 인물과 10개의 객체에 대한 정체성 일관성도 유지합니다. 1K, 2K, 4K 이미지 해상도를 지원하며 기본값은 1K입니다. 1:1, 3:2, 2:3, 3:4, 1:4, 4:1, 4:3, 4:5, 5:4, 1:8, 8:1, 9:16, 16:9, 21:9 비율을 지원하고, 2K와 4K에서 와이드·파노라마 비율의 타일링 아티팩트를 수정했습니다. 입력 이미지는 장당 1,120 토큰을 소비하고 출력 이미지 토큰은 1K에서 1,120, 2K에서 1,680, 4K에서 3,780입니다. 전문가 수준의 정밀한 이미지 제작과 편집, 여러 차례에 걸친 빠른 반복 편집, 포스터와 복잡한 다이어그램의 선명한 텍스트 생성, 다국어 국소 텍스트 렌더링, 스토리텔링과 반복 워크플로를 위한 다중 턴 대화형 편집에 적합합니다. 제품 장면과 다인물 장면, 시리즈 자산을 위한 다중 이미지 융합, 가상 피팅과 캐릭터 생성에도 활용할 수 있습니다.

사용 요금은 어떻게 계산되나요?

이용하는 제공 업체의 요금과 실제 사용량에 따라 비용이 결정됩니다. 긴 입력 등에는 다른 요금이 적용될 수 있습니다. 실제 생성 비용을 기준으로 과금됩니다. 최종 금액은 청구 내역을 확인하세요.

Nano Banana 2.1은 어떤 입력을 지원하나요?

텍스트, 이미지, 비디오, PDF 입력을 지원하며 이미지와 텍스트 출력을 생성합니다. 비디오 입력에서 이미지를 생성할 수도 있습니다.

컨텍스트와 출력 길이는 얼마인가요?

컨텍스트는 131,072, 출력 한도는 32,768입니다.

어떤 작업에 가장 적합한가요?

전문가 수준의 이미지 제작과 편집, 여러 차례의 반복 편집, 포스터와 복잡한 다이어그램의 선명한 텍스트 생성에 적합합니다. 다중 턴 대화형 편집과 다중 이미지 융합, 가상 피팅에도 활용할 수 있습니다.

동일 시리즈 모델과 어떻게 다른가요?

Nano Banana 2.1은 Gemini 3.1 Flash Image 기반의 Nano Banana 2를 업그레이드한 모델입니다. Gemini 3 Pro Image(Nano Banana Pro)에 준하는 품질을 제공하는 고효율 대안으로 자리매김합니다.

이미지 해상도와 비율은 어떻게 되나요?

1K, 2K, 4K 해상도를 지원하며 기본값은 1K입니다. 1:1, 3:2, 2:3, 3:4, 1:4, 4:1, 4:3, 4:5, 5:4, 1:8, 8:1, 9:16, 16:9, 21:9 비율을 지원합니다.

지원하지 않는 기능이 있나요?

temperature, topP, topK, seed, logprobs 파라미터를 지원하지 않으며 설정 시 API 오류가 반환됩니다. 오디오 생성, 캐싱, 코드 실행, 파일 검색, 함수 호출, 구조화된 출력도 지원하지 않습니다.

관련 모델