제품 & 라이프스타일 컨셉
프롬프트로 제품 관련 장면을 만들거나, 제품 사진 한 장을 다른 비주얼 처리로 수정하세요.
Nano Banana API. 이미지 생성과 편집.
Topview API로 Nano Banana 이미지 생성과 편집을 제품에 넣으세요. 지원 화면비 다섯 가지로 생성하고, 입력 이미지 한 장을 편집하며, 선택 가능한 해상도 티어 없이 명확한 이미지당 요금을 사용합니다.
공식 요금보다 저렴화면비 5종표준 출력 크기 1종단일 이미지 편집
Nano Banana API 무료로 사용해 보기
설정
Text to Image
여기 설정은 미리보기입니다. 생성을 누르면 프롬프트가 복사되고 해당하는 Platform Playground가 열려 최종 설정을 확인할 수 있습니다.
모델 사양
구축 전에 설정을 파악하세요.
Topview API Platform 문서에 나온 Nano Banana 설정 빠른 참고입니다. 모드마다 입력 요건이 다릅니다.
| 파라미터 | 값 |
|---|---|
| 제공자 / 모델 | Google / Nano Banana |
| API 라우트 | google/nano-banana |
| 생성 모드 | Text to Image · Image Editing |
| 해상도 | Standard output (no resolution parameter) |
| 화면비 | 1:1 · 16:9 · 9:16 · 4:3 · 3:4 |
| Image Editing 입력 | 1 image |
| 프롬프트 길이 | Up to 4,000 characters |
| 작업 패턴 | Async submission + polling + output retrieval |
| 가격 | Per generated image; settlement follows actual usage |
개발자 퀵스타트
API 키에서 첫 이미지까지.
Platform API 키로 비동기 예측을 제출한 뒤, 반환된 작업 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/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",
"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 text-to-image 요청과 일치합니다. TOPVIEW_API_PLATFORM_KEY는 서버에만 보관하세요.
단계 1
API 키 받기
Topview API Platform에 로그인해 필요한 모델 권한이 있는 API 키를 만드세요. 키는 안전하게 보관하고 API 요청 인증에만 사용하세요.
단계 2
이미지 생성 또는 편집
텍스트 프롬프트를 제출하거나 편집용 참조 이미지를 업로드하세요. 지원 이미지 설정을 구성하고 API 요청을 보낸 뒤, 반환된 작업 ID를 저장하세요.
단계 3
이미지 가져오기
생성이 완료될 때까지 작업 상태를 확인하세요. 이미지 URL을 가져오고 최종 사용 비용을 검토한 뒤 생성된 이미지를 저장하세요.
프로덕션 워크플로를 위해
일상 앱에 간단한 이미지 생성·편집을 추가
오리지널 Nano Banana API는 표준 출력 크기 하나와 집중된 참조 편집 컨트롤로 일반적인 이미지 생성 작업을 지원합니다.
다섯 비율의 소셜 그래픽
4:3과 3:4를 포함한 지원 화면비 다섯 가지로 정사각·가로·세로 컨셉을 생성하세요.
단일 이미지 크리에이티브 편집
편집 입력 한 장으로 사용자가 사진 스타일을 바꾸거나 주변 환경을 변경하고 새 구도를 탐색하게 하세요.
스타터 이미지 기능
크리에이터 도구, 내부 워크플로, 소규모 마케팅 앱에 기본 text-to-image와 단일 이미지 편집을 추가하세요.
왜 TOPVIEW API인가
오리지널 Nano Banana API를 위한 간단한 진입점
최신 Nano Banana 변형이 아닌 오리지널 모델을 원하는 팀을 위해 Topview는 문서화된 모드와 포맷 옵션을 제공합니다.
표준 크기 요금 모델
지원되지 않는 2K·4K 해상도 선택기를 추가하지 않고 현재 이미지당 요금을 확인하세요.
지원 화면비 다섯 가지
제품 출력 설정을 매핑하기 전에 1:1, 16:9, 9:16, 4:3, 3:4를 테스트하세요.
단일 이미지 편집 테스트
전용 편집 라우트와 문서화된 입력 요건으로 소스 사진 한 장의 프롬프트 기반 편집을 살펴보세요.
Nano Banana 패밀리 비교
출력·편집 요구가 바뀌어도 하나의 Topview 워크스페이스에서 오리지널 모델을 Lite, 2, 2.1과 비교해 보세요.
Nano Banana API FAQ
Nano Banana Playground를 열어 설정을 살펴볼 수 있습니다. API 사용은 Platform USD 잔액에서 결제되며, 프로모션 크레딧은 시기에 따라 달라집니다. Topview API Platform에서 워크스페이스의 현재 자격과 잔액을 확인하세요.
Topview API Platform에는 Text to Image와 Image Editing이 있습니다. Image Editing은 프롬프트와 함께 입력 이미지 한 장을 받습니다.
Nano Banana는 1:1, 16:9, 9:16, 4:3, 3:4를 지원합니다. 해상도 파라미터는 없으며, 각 요청은 표준 출력 크기 하나를 반환합니다.
Nano Banana와 Nano Banana 2 Lite는 모두 해상도 선택기 없는 단순한 이미지당 요금을 제공합니다. 지원 화면비, 편집 입력, 현재 요금을 기준으로 선택하세요. 선택 가능한 2K·4K 출력이 필요하면 Nano Banana 2와 Nano Banana 2.1을 비교하세요.
Platform API 키를 만들고 Idempotency-Key와 함께 Nano Banana 엔드포인트에 예측을 제출한 뒤, 반환된 작업 ID를 저장하고 완료될 때까지 폴링하세요. 결과 URL은 만료될 수 있으니 이미지를 速やか히 다운로드하세요. 키는 서버에 보관하세요.
관련 API 살펴보기
더 많은 AI 이미지 모델, 한곳에서.
다음 이미지는 여기서 시작
Nano Banana API로 구축하기
Playground에서 첫 프롬프트를 시도하고, 현재 가격을 비교하거나, 문서에 따라 Nano Banana를 앱에 연동하세요.