모드: Text to Image
제품 샷
광고·리스팅·소셜을 위해 한 제품을 여러 장면에 배치합니다.
Nano Banana 2.1 API. 4K 이미지, 이미지당 요금.
Topview API로 Nano Banana 2.1 이미지 생성·편집을 제품에 도입하세요. 14가지 화면비로 1K·2K·4K를 만들고 최대 14장 입력으로 편집하며, 투명한 이미지당 요금·즉시 사용 가능한 Playground·개발자 문서를 제공합니다.
공식 요금보다 저렴1K · 2K · 4K14가지 화면비최대 14장으로 편집
Nano Banana 2.1 API 무료로 사용해 보기
설정
Text to Image · 1k
여기 설정은 미리보기입니다. Generate는 프롬프트를 복사하고 해당 Platform Playground를 엽니다. 최종 설정은 거기서 확인하세요.
예시 & 프롬프트
Nano Banana 2.1 API로 만들 수 있는 결과
실제 Nano Banana 2.1 출력과 프롬프트입니다. 프롬프트를 복사해 Playground에서 테스트하세요.
모드: Text to Image
포스터와 인포그래픽
캠페인 레이아웃용으로 헤드라인과 라벨이 더 깔끔한 포스터·인포그래픽을 생성합니다.
모드: Text to Image
캐릭터 시리즈
만화·캠페인·스토리보드 시퀀스에서 같은 캐릭터를 유지합니다.
모드: Text to Image
영상 썸네일
자체 영상을 참조로 사용해 콘텐츠에 맞는 썸네일과 커버 이미지를 만듭니다.
모델 사양
구축하기 전에 설정을 파악하세요.
Topview API Platform 문서에 게시된 Nano Banana 2.1 설정의 빠른 참고입니다. 모드마다 입력 요구사항이 다릅니다.
| 파라미터 | 값 |
|---|---|
| 제공자 / 모델 | Google / Nano Banana 2.1 |
| API 경로 | google/nano-banana-2.1 |
| 생성 모드 | Text to Image · Image Editing |
| 해상도 | 1K · 2K · 4K（기본 1K） |
| 화면비 | 1:1 · 3:2 · 2:3 · 3:4 · 4:3 · 4:5 · 5:4 · 9:16 · 16:9 · 21:9 · 1:4 · 4:1 · 1:8 · 8:1 |
| Image Editing 입력 | 1–14 images |
| 프롬프트 길이 | 최대 10,000자 |
| 작업 패턴 | 비동기 제출 + 폴링 + 출력 조회 |
| 가격 | 생성 이미지당; 정산은 실제 사용 기준 |
개발자 퀵스타트
API 키에서 첫 이미지까지.
Platform API 키로 비동기 prediction을 제출한 뒤, 반환된 작업 ID를 폴링해 출력을 가져옵니다.
# Set TOPVIEW_API_PLATFORM_KEY once. Preserve REQUEST_KEY and input for uncertain retries.
# For a NEW task only, unset REQUEST_KEY first. Save data.id to resume GET only.
: "${TOPVIEW_API_PLATFORM_KEY:?Set TOPVIEW_API_PLATFORM_KEY first}"
export REQUEST_KEY="${REQUEST_KEY:-$(uuidgen)}"
curl --fail-with-body 'https://platform-backend.topview.ai/api/v1/models/google/nano-banana-2.1/text-to-image/predictions' \
-H "Authorization: Bearer $TOPVIEW_API_PLATFORM_KEY" \
-H "Idempotency-Key: $REQUEST_KEY" \
-H 'Content-Type: application/json' \
--data '{
"prompt": "A blue ceramic cup on a wooden table",
"resolution": "1k",
"aspect_ratio": "1:1"
}'
# Poll data.id until completed or failed.
curl --fail-with-body 'https://platform-backend.topview.ai/api/v1/predictions/REQUEST_ID' \
-H "Authorization: Bearer $TOPVIEW_API_PLATFORM_KEY"샘플은 Platform 문서의 Nano Banana 2.1 텍스트→이미지 요청과 일치합니다. TOPVIEW_API_PLATFORM_KEY는 서버에만 보관하세요.
단계 1
API 키 받기
Topview API Platform에 로그인한 뒤 필요한 모델 권한이 있는 API 키를 만드세요. 키를 안전하게 보관하고 API 요청 인증에 사용하세요.
단계 2
이미지 생성 또는 편집
텍스트 프롬프트를 제출하거나 편집용 참조 이미지를 업로드하세요. 지원되는 이미지 설정을 구성하고 API 요청을 보낸 뒤 반환된 작업 ID를 저장하세요.
단계 3
이미지 가져오기
생성이 완료될 때까지 작업 상태를 확인하세요. 이미지 URL을 가져오고 최종 사용 비용을 확인한 뒤 생성된 이미지를 저장하세요.
프로덕션 워크플로를 위해
유연하고 참조가 많은 이미지 워크플로 구축
Nano Banana 2.1은 고해상도 자산, 독특한 화면비, 다중 이미지 편집을 지원해 단일 소스 사진 이상이 필요한 크리에이티브 시스템에 적합합니다.
다중 이미지 제품 합성
편집 요청에서 제품·장면·스타일 이미지를 결합해 더 풍부한 이커머스 비주얼과 캠페인 구도를 만듭니다.
포맷 간 캠페인 자산
배너 친화 형식을 포함한 14가지 화면비로 정사각·세로·가로·초광각 이미지를 만듭니다.
4K 브랜드·에디토리얼 비주얼
고세부 크리에이티브 컨셉, 마케팅 레이아웃, 비주얼 콘텐츠용으로 1K·2K·4K를 생성·편집합니다.
참조 기반 디자인 워크플로
유도 구도·비주얼 업데이트·크리에이티브 탐색을 위해 최대 14장의 소스 이미지를 받는 편집 도구를 구축합니다.
왜 TOPVIEW API인가
더 많은 참조 입력과 출력 크기를 하나의 API에서
제품에 구현하기 전에 Topview에서 Nano Banana 2.1의 더 넓은 이미지 입력과 포맷 옵션을 탐색하세요.
최대 14장 편집 입력 시험
Playground에서 실제 소스 이미지 조합을 시험하고, 통합 시 Image Editing 스키마를 따르세요.
출력 해상도별 가격
모든 구성이 동일 가격이라고 가정하지 말고 1K·2K·4K의 이미지당 요금을 비교하세요.
독특한 화면비 미리보기
와이드 배너·소셜 배치·특수 크리에이티브용 14가지 비율 전체를 검증하세요.
이미지 모델을 한 워크스페이스에서
별도 제공자 계정 없이 Nano Banana 2.1과 Nano Banana 2 등 이미지 API를 비교하세요.
Nano Banana 2.1 API FAQ
Nano Banana 2.1 Playground를 열어 설정을 확인할 수 있습니다. API 사용은 Platform USD 잔액에서 결제되며, 프로모션 크레딧은 시기에 따라 달라집니다. 워크스페이스 자격과 잔액은 Topview API Platform에서 확인하세요.
Topview API Platform에는 Text to Image와 Image Editing이 게시되어 있습니다. Image Editing은 프롬프트와 함께 입력 이미지 1–14장을 받습니다.
Nano Banana 2.1은 1K·2K·4K를 출력하며 1:1·16:9부터 1:8·8:1 같은 극단 형식까지 14가지 화면비를 지원합니다. 가격은 해상도에 따라 달라집니다.
생성 이미지마다 해상도별 요금으로 청구되며, 현재 Text to Image와 Image Editing은 같은 요금입니다. 제출 시 자금이 예약되고, 최종 비용은 완료된 작업의 charged_usd를 확인하세요.
Platform API 키를 만들고 Idempotency-Key와 함께 Nano Banana 2.1 엔드포인트에 prediction을 제출한 뒤, 반환된 작업 ID를 저장하고 완료될 때까지 폴링하세요. 결과 URL은 만료될 수 있으니 이미지를 빠르게 다운로드하고 키는 서버에 보관하세요.
관련 API 살펴보기
더 많은 AI 이미지 모델, 한곳에서.
다음 이미지는 여기서 시작
Nano Banana 2.1 API로 구축하기
Playground에서 첫 프롬프트를 시험하고, 현재 가격을 비교하거나 문서에 따라 Nano Banana 2.1을 앱에 통합하세요.