Runbase

Command Palette

Search for a command to run...

Gemini

Nano Banana 2 Lite

ID:google/nano-banana-2-lite

Nano Banana 2 Lite: Gemini 3.1 Flash Lite Image 기반, 약 4초 생성, 1K 해상도, 이미지당 균일 가격.

텍스트 투 이미지이미지 편집참조 이미지1K고속

개요

Nano Banana 2 Lite: Gemini 3.1 Flash Lite Image 기반, 약 4초 생성, 1K 해상도, 이미지당 균일 가격.

인증

모든 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-lite",
    "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-lite",
    "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
image_urlsstring[]선택Reference images최대 14장의 이미지

출력 스키마

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

오류

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

상태 코드설명
400Ungültige Anfrage – fehlende oder fehlerhafte Parameter
401Authentifizierung fehlgeschlagen – fehlender oder ungültiger API-Schlüssel
402Unzureichendes Guthaben
403Zugriff verweigert – IP nicht erlaubt, Konto gesperrt oder Ausgabenlimit des API-Schlüssels überschritten
404Ausführung nicht gefunden
429Rate-Limit überschritten
500Interner Serverfehler