Nano Banana 2.1

ID:google/nano-banana-2.1

Google의 Nano Banana 2.1 이미지 생성 API — 비주얼 디자인, 편집, 피사체 일관성을 강화한 Gemini Flash 이미지 모델, 최대 4K와 참조 이미지 14장 지원.

Nano Banana 2.1Gemini ImageGoogle이미지 편집4K

개요

Google의 Nano Banana 2.1 이미지 생성 API — 비주얼 디자인, 편집, 피사체 일관성을 강화한 Gemini Flash 이미지 모델, 최대 4K와 참조 이미지 14장 지원.

인증

모든 API 요청은 Authorization 헤더에 Bearer 방식으로 유효한 API 키를 전달해야 합니다.

빠른 시작

인증 정보

RUNBASE_API_KEY 환경 변수를 설정하세요.

Shell

export RUNBASE_API_KEY=your-api-key

실행 생성

Shell

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana-2.1",
    "input": {
      "prompt": "A cinematic product photo of a ceramic lamp"
    }
  }'

실행

실행은 비동기로 처리됩니다. 요청을 제출한 후 결과를 폴링하세요.

실행 생성

Shell

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana-2.1",
    "input": { "prompt": "A cinematic product photo of a ceramic lamp" }
  }'

실행 상태 조회

Shell

curl -s https://runbase.net/api/v1/runs/RUN_ID \
  -H "Authorization: Bearer $RUNBASE_API_KEY"

결과 조회

status가 "succeeded"가 될 때까지 상태 엔드포인트를 폴링한 후 응답에서 output.urls를 읽으세요.

입력 스키마

매개변수	유형	필수	설명
prompt	string	필수	Prompt
aspect_ratio	string	선택	Aspect ratio옵션: `1:11:41:82:33:23:44:14:34:55:48:19:1616:921:9auto`
resolution	string	선택	Resolution옵션: `1K2K4K`
image_urls	string[]	선택	Reference images

출력 스키마

필드	유형	설명
urls	string[]	생성된 출력 URL

오류

API는 표준 HTTP 상태 코드를 사용하여 성공 또는 실패를 나타냅니다.

상태 코드	설명
400	잘못된 요청 - 매개변수가 누락되었거나 형식이 올바르지 않습니다
401	인증 실패 - API 키가 누락되었거나 유효하지 않습니다
402	크레딧 부족
403	접근 거부 - IP가 허용되지 않았거나, 계정이 차단되었거나, API 키 지출 한도 초과
404	실행을 찾을 수 없습니다
429	요청 속도 제한 초과
500	내부 서버 오류