Nano Banana

ID:google/nano-banana

Google의 Nano Banana 이미지 생성 API — 11가지 종횡비와 최대 10장의 참조 이미지를 지원하는 합리적 가격의 Gemini 2.5 Flash 기반 모델.

텍스트-투-이미지이미지 편집참조 이미지

개요

Google의 Nano Banana 이미지 생성 API — 11가지 종횡비와 최대 10장의 참조 이미지를 지원하는 합리적 가격의 Gemini 2.5 Flash 기반 모델.

인증

모든 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",
    "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",
    "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:12:33:23:44:34:55:49:1616:921:9auto`
image_urls	string[]	선택	Reference images

출력 스키마

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

오류

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

상태 코드	설명
400	Request không hợp lệ - thiếu hoặc sai định dạng tham số
401	Xác thực thất bại - thiếu hoặc sai khóa API
402	Không đủ tín dụng
403	Bị từ chối - IP không được phép hoặc khóa API vượt giới hạn chi tiêu
404	Không tìm thấy lượt chạy
429	Vượt giới hạn tốc độ
500	Lỗi máy chủ nội bộ