소개
피사체, 배경과 표현 방식을 적은 다음 고정 화면비 14종 중에서 선택합니다.
| 항목 | 값 |
|---|---|
| 입력 | 텍스트 |
| 출력 | 이미지 |
| 배포사 및 모델 | Google; Gemini 3.1 Flash Lite Image |
| 작업 종류 | 텍스트 생성과 이미지 편집 |
| 출력 단계 | 1K, 약 100만화소 |
| 프롬프트 용량 | 최대 20,000자 |
| 고정 화면비 | 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 1:4, 4:1, 1:8, 8:1 |
| 생성 기본값 | 1:1 |
| 편집 화면비 선택 | 고정 비율 14가지와 auto |
| 편집 입력 수 | 1~10장, Image 1, Image 2 이후로 지정 |
| 청구 기준 | 이미지당 고정 요금, 실패 요청 무료 |
| 콘텐츠 제한 | 배포사 자체 필터로 표시된 요청은 과금 없이 거부 |
| 파일 보관 기간 | 14일 후 생성 파일 삭제 |
핵심 기능 및 하이라이트
자세가 달라도 같은 커플
1:4 생성은 웃음, 입맞춤, 장난스러운 넥타이 당기기, 이마 맞대기의 4프레임 흑백 포토부스 띠를 만들었습니다. 커플은 연속 장면에서 일관됐습니다. 순서를 적고 좁은 비율을 설정합니다. 네 프레임을 포함한 한 이미지이며 모든 출연자·배치의 결과를 약속하지 않습니다.
열차 안의 독서 공간
따뜻한 실내와 바깥 비의 대비에서 시작한 열차 예시는 독서 코너를 만들었습니다. 가구와 빛을 구체화하고 창과 좌석이 들어갈 비율을 고릅니다. 1K에서 구도를 검토한 뒤 더 큰 버전의 필요를 판단할 수 있습니다.
초록 식물을 둘러싼 겨울빛
햇빛 드는 온실은 테스트에서 유리의 서리와 차가운 빛을 가진 겨울 아침으로 바뀌었고 실내 식물은 녹색이었습니다. 유리·조명을 비교한 뒤 식물을 따로 확인합니다. 온실을 Image 1로 부르고 계절 변경과 유지 요소를 모두 명시합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 장면을 최대 20,000자로 묘사합니다. 프롬프트에 별도 가격 단계는 없습니다. 1자 이상 · 20000자 이하 |
aspect_ratio | 아니요 | 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 1:4, 4:1, 1:8, 8:1 중에서 고릅니다. 생성 기본값은 1:1이며 어떤 비율이든 Lite 이미지 고정 요금을 유지합니다. |
요금
$0.027 / 장
Lite 텍스트 생성은 이미지마다 고정 단가로 청구합니다. 비율에 따른 요금 차이는 없고 실패한 작업은 과금하지 않습니다.
활용 사례
사진 띠 이야기
좁은 1:4 구도에 커플의 네 순간을 배치합니다. 흑백 포토부스 결과는 자세가 바뀌어도 같은 커플을 알아볼 수 있게 유지했습니다.
실내 분위기 구상
방 콘셉트를 발전시키기 전 빗속 주변과 따뜻한 실내 빛을 탐색합니다. 열차 테스트는 이 장소에 독서 공간을 만들었습니다.
계절에 따른 장소 수정
실내에서 남길 것을 정하며 겨울 분위기를 요청합니다. 온실 편집은 식물을 녹색으로 두고 서리 유리와 차가운 빛을 추가했습니다.
특별한 배치를 위한 캔버스
좁거나 파노라마형 이미지에는 1:8, 8:1 등 지원 비율을 고릅니다. 구도는 바뀌지만 더 큰 해상도가 추가되지는 않습니다.
번호 참조를 담은 구상
기존 자료가 필요한 편집은 원본 1~10장을 사용합니다. 역할을 설명하고 결과를 해당 원본과 대조합니다.
프롬프트 가이드 및 실전 팁
출발점 선택
장면 설명은 텍스트 생성, 수정할 사진은 이미지 편집을 엽니다. 인물은 사용 권한이 있는 성인 사진을 쓰고 사칭하지 않습니다.
장면 방향 제시
장소, 빛, 눈에 보이는 행동을 적습니다. 편집은 입력을 Image 1, Image 2 이후로 연결하고 변경과 유지 요소를 나눕니다.
캔버스 비율 선택
세로 사진 띠의 1:4처럼 생성의 고정 비율을 고릅니다. 편집은 원본 비율을 따르는 auto도 제공하며 모든 선택은 1K입니다.
검토 후 다운로드
채택 전 얼굴, 사물, 구도를 설명과 비교합니다. 14일 안에 파일을 받아 프롬프트·설정과 보관합니다.
1K 단계의 장면 설명
Nano Banana 2 Lite 텍스트 생성은 설명을 사진으로 바꿉니다. 출력은 화면비 14가지 모두 약 100만화소인 1K입니다. 방, 인물, 풍경, 사진 띠 등 아이디어에서 시작할 때 사용합니다. 기존 사진으로 수정을 안내하려면 이미지 편집을 사용합니다.
Google은 낮은 지연과 비용을 목표로 한다고 설명합니다. 실측 시간은 기록에 없어 배포사의 설명을 전달 예상치로 보지 않습니다. 기록 샘플은 열차 독서 공간과 4프레임 포토부스 띠입니다.
파라미터와 캔버스
| 파라미터 | 보낼 내용 | 동작 |
|---|---|---|
| prompt | 최대 20,000자의 장면 설명 | 대상, 장소, 행동, 빛 명시 |
aspect_ratio | 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 1:4, 4:1, 1:8, 8:1 | 기본 1:1, 모두 1K |
형태 제어가 비율을 결정합니다. 세로 사진 띠라고 적어도 원하는 캔버스의 1:4를 선택합니다. 8:1은 파노라마, 1:8은 좁은 세로입니다. 다른 형태에 이미지를 분배할 뿐 2K·4K를 추가하지 않으며 텍스트 생성에는 auto가 없습니다.
확인 가능한 프롬프트
보이는 장면 정의
분위기 전에 중심 대상을 적습니다. 열차 실내는 창가 좌석, 읽을 자료, 실내 빛, 바깥 비를 설명합니다. 넉넉한 글자 한도가 있어도 긴 분위기 단어 목록보다 구체적인 사물이 결과 비교에 유용합니다.
인물은 30대 이상이며 옷·표정·장소를 명시합니다. 부드러운 포토부스 빛 속 30대 후반 커플의 드레스와 정장처럼 적고 관련 없는 장소나 충돌하는 조명 없이 공유 행동을 설명합니다.
한 이미지의 순서
사진 띠는 출연자와 배치가 모두 필요합니다. 세로로 쌓인 프레임, 계속 같은 커플, 행동 순서, 같은 옷과 사진 표현을 적습니다. 여러 개별 사진이 아닌 프레임들이 들어 있는 한 이미지입니다.
같은 30대 후반 커플의 웃음, 짧은 입맞춤, 넥타이로 가까이 당기기, 이마 맞대기를 흑백 필름 입자의 네 세로 프레임으로 설명하고 aspect_ratio 1:4를 고릅니다. 채택 전 수, 순서, 알아볼 외형을 확인합니다.
유용한 변형 기록
램프 색이나 표정 등 구체적인 부분을 바꾸며 탐색합니다. 채택 이미지마다 프롬프트와 비율을 저장해 선호 방향을 남깁니다. 예시는 특정 결과이며 다른 요청의 동일 얼굴·구도를 보장하지 않습니다.
샘플 결과
- 열차 테스트는 알아볼 수 있는 장소에 독서 공간을 만들었습니다.
- 1:4 포토부스는 웃음, 입맞춤, 넥타이 당기기, 이마 맞대기를 흑백 네 프레임에 일관된 커플로 반환했습니다.
- 표시 구도에 대한 관찰이며 모든 다중 패널 이야기의 성능이나 실측 완료 시간을 입증하지 않습니다.
새 포토부스 표지는 일러스트이며 생성 띠 샘플과 별개입니다. 관찰 출력을 판단할 때 샘플과 설정을 사용합니다.
요금, 필터, 보관
생성 이미지당 고정 요금이며 화면비는 영향을 주지 않고 실패는 무료입니다. Nano Banana 2 Lite 모델 페이지의 현재 요금으로 작업을 계획합니다. 이 안내는 금액을 고정하지 않고 규칙을 설명합니다.
배포사 자체 필터가 표시한 요청은 과금 없이 거부합니다. 예시 수락이 다른 프롬프트 수락을 입증하지 않습니다. 파일은 14일 후 삭제되므로 보관할 이미지를 받습니다.
다음 작업 선택
새 1K 구도를 정의할 동안 텍스트 생성을 사용합니다. 원본을 바탕으로 바꾸면 입력 1~10장과 auto 비율을 추가하는 Lite 편집으로 전환합니다. 더 큰 출력에는 2K·4K의 Nano Banana 2.1을 사용하며 Lite는 이미지당 더 저렴합니다. 비율로 해상도를 늘리려 하지 말고 필요한 단계와 시작 자료로 정합니다.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "google/nano-banana-2-lite/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.






