Nano Banana 2.1
ID:
google/nano-banana-2.1Google의 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최대 20000자 |
| aspect_ratio | string | 선택 | Aspect ratio옵션: 1:11:41:82:33:23:44:14:34:55:48:19:1616:921:9auto기본값: 1:1 |
| resolution | string | 선택 | Resolution옵션: 1K2K4K기본값: 1K |
| image_urls | string[] | 선택 | Reference images최대 14장의 이미지 |
출력 스키마
| 필드 | 유형 | 설명 |
|---|---|---|
| urls | string[] | 생성된 출력 URL |
오류
API는 표준 HTTP 상태 코드를 사용하여 성공 또는 실패를 나타냅니다.
| 상태 코드 | 설명 |
|---|---|
| 400 | 無效請求 - 缺少或格式錯誤的參數 |
| 401 | 驗證失敗 - 缺少或無效的 API 金鑰 |
| 402 | 點數不足 |
| 403 | 禁止存取 - IP 不被允許、帳號被封禁或 API 金鑰消費上限已超過 |
| 404 | 找不到執行紀錄 |
| 429 | 超過速率限制 |
| 500 | 內部伺服器錯誤 |

