Runbase

Command Palette

Search for a command to run...

Gemini

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를 읽으세요.

입력 스키마

매개변수유형필수설명
promptstring필수Prompt최대 20000자
aspect_ratiostring선택Aspect ratio옵션: 1:11:41:82:33:23:44:14:34:55:48:19:1616:921:9auto기본값: 1:1
resolutionstring선택Resolution옵션: 1K2K4K기본값: 1K
image_urlsstring[]선택Reference images최대 14장의 이미지

출력 스키마

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

오류

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

상태 코드설명
400無效請求 - 缺少或格式錯誤的參數
401驗證失敗 - 缺少或無效的 API 金鑰
402點數不足
403禁止存取 - IP 不被允許、帳號被封禁或 API 金鑰消費上限已超過
404找不到執行紀錄
429超過速率限制
500內部伺服器錯誤