소개
번호를 붙인 원본 이미지와 함께 원하는 변경 사항, 유지할 세부 요소를 설명한 지시를 보냅니다.
| 항목 | 값 |
|---|---|
| 입력 | 이미지 |
| 출력 | 이미지 |
| 배포사 및 모델 | 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자로 설명하고 입력을 Image 1, Image 2 등으로 지칭합니다. 텍스트 길이는 고정 단가에 영향을 주지 않습니다. 1자 이상 · 20000자 이하 |
image_urls | 예 | 수정의 기준이 될 원본 이미지 URL 1–10개를 보냅니다. 원본 수가 아니라 생성한 이미지 수에 따라 과금합니다. 1개 이상 · 10개 이하 |
aspect_ratio | 아니요 | auto로 원본을 따르거나 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을 고릅니다. 화면비 선택은 Lite 요금을 변경하지 않습니다. |
요금
$0.027 / 장
Lite 이미지 편집은 비율이나 원본 수와 무관하게 생성 이미지당 고정 요금을 적용합니다. 수정에 실패하면 청구하지 않습니다.
활용 사례
사진 띠 이야기
좁은 1:4 구도에 커플의 네 순간을 배치합니다. 흑백 포토부스 결과는 자세가 바뀌어도 같은 커플을 알아볼 수 있게 유지했습니다.
실내 분위기 구상
방 콘셉트를 발전시키기 전 빗속 주변과 따뜻한 실내 빛을 탐색합니다. 열차 테스트는 이 장소에 독서 공간을 만들었습니다.
계절에 따른 장소 수정
실내에서 남길 것을 정하며 겨울 분위기를 요청합니다. 온실 편집은 식물을 녹색으로 두고 서리 유리와 차가운 빛을 추가했습니다.
특별한 배치를 위한 캔버스
좁거나 파노라마형 이미지에는 1:8, 8:1 등 지원 비율을 고릅니다. 구도는 바뀌지만 더 큰 해상도가 추가되지는 않습니다.
번호 참조를 담은 구상
기존 자료가 필요한 편집은 원본 1~10장을 사용합니다. 역할을 설명하고 결과를 해당 원본과 대조합니다.
프롬프트 가이드 및 실전 팁
출발점 선택
장면 설명은 텍스트 생성, 수정할 사진은 이미지 편집을 엽니다. 인물은 사용 권한이 있는 성인 사진을 쓰고 사칭하지 않습니다.
장면 방향 제시
장소, 빛, 눈에 보이는 행동을 적습니다. 편집은 입력을 Image 1, Image 2 이후로 연결하고 변경과 유지 요소를 나눕니다.
캔버스 비율 선택
세로 사진 띠의 1:4처럼 생성의 고정 비율을 고릅니다. 편집은 원본 비율을 따르는 auto도 제공하며 모든 선택은 1K입니다.
검토 후 다운로드
채택 전 얼굴, 사물, 구도를 설명과 비교합니다. 14일 안에 파일을 받아 프롬프트·설정과 보관합니다.
글로 지시해 사진 수정
Nano Banana 2 Lite 편집은 기존 시각 자료와 수정 프롬프트를 받습니다. 이미지 1~10장에 번호별 역할과 변경·유지 요소를 설명합니다. 출력은 약 100만화소인 1K입니다. 원본 요소를 이어 갈 특정 장소·조명 구상에 적합합니다.
온실 샘플은 햇빛 드는 장소를 서리 유리와 차가운 빛의 겨울 아침으로 바꾸며 식물을 녹색으로 유지했습니다. 해당 편집의 근거이며 요청 밖 모든 부분의 동일성을 보장하지 않습니다.
편집 파라미터
| 파라미터 | 허용 입력 | 사용법 |
|---|---|---|
| prompt | 최대 20,000자 | 원본 번호, 변경, 보존 요소 명시 |
image_urls | 원본 URL 1~10개 | 순서에 맞춰 Image 1, Image 2 이후 지정 |
aspect_ratio | auto, 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 | 원본 비율은 auto, 또는 고정 캔버스 |
편집은 생성의 고정 14가지에 auto를 추가합니다. 원본 비율이 중요하면 직접 고릅니다. 다중 입력의 비율이 모두 같다고 가정하지 말고 최종 배치가 특정 형태면 고정 비율을 선택합니다. 어떤 선택도 큰 출력 단계를 추가하지 않습니다.
읽기 쉬운 참조 역할
입력과 목적 연결
이미지 번호로 어디를 볼지 정합니다. Image 1의 온실 사용처럼 시작해 겨울 분위기를 설명합니다. 추가 사진이 필요하면 Image 2 이후 기여를 적고 image_urls 순서를 확인합니다.
최대 10장 용량이 복잡한 묶음의 일관된 결과 보장은 아닙니다. Google은 Lite가 다중 참조나 여러 차례의 연속 편집에 최적화되지 않았다고 설명합니다. 온실 관찰은 특정 계절 변경이며 긴 수정 과정의 신뢰성을 입증하지 않습니다.
변경과 보존 구분
유리에 서리를 추가하고 자연광을 차갑게 하되 실내 식물은 녹색으로 유지하도록 나눠 적습니다. 중요한 구조·사물을 지정하고 반환 후 원본과 비교합니다.
샘플은 서리 유리, 차가운 빛, 녹색 식물을 뒷받침합니다. 길이나 식재 배치 보존도 요청할 수 있지만 실측 결과로 취급하지 말고 직접 확인합니다. 일반적인 품질 요청 반복보다 보이는 요건에 글자 공간을 씁니다.
허용된 인물 사진
사용 권한이 있는 성인 사진을 쓰고 사칭하지 않습니다. 새 인물 구상은 30대 이상과 옷·표정·빛·주변을 적습니다. 동일 인물 요건을 분명히 하고 사용 전에 허용 원본과 얼굴을 대조합니다.
Image 1의 허가된 40대 여성에 파란 배경과 따뜻한 스튜디오 빛을 추가하며 남색 재킷과 앉은 자세를 유지하는 식으로 적을 수 있습니다. 테스트 인물 결과가 없는 지시 제안입니다.
원본과 결과 검토
온실을 다음 순서의 예시로 사용합니다.
- 유리와 자연광에서 계절 분위기 변화를 비교합니다.
- 실내 식물의 요청한 녹색을 확인합니다.
- 구도와 주변을 살핀 뒤 적합성을 정합니다.
- 원본, 지시, 비율, 채택 출력을 함께 저장합니다.
추가 수정은 남은 문제를 직접 지정합니다. 계절·가구·시점·스타일을 한꺼번에 바꾸기보다 집중한 후속 지시가 평가하기 쉽습니다. 기록은 긴 편집 이력이나 완료 시간을 측정하지 않았습니다.
과금과 운영 한도
출력 이미지당 고정 요금이며 화면비는 영향을 주지 않고 실패는 과금하지 않습니다. 가이드에 복사한 금액 대신 모델 페이지의 현재 요금으로 추산합니다.
배포사 필터가 표시한 요청은 무료 거부이며 수정에도 새 이미지와 같은 수락 경계를 적용합니다. 14일 후 삭제되므로 채택 편집을 받고 원본도 프로젝트에 보관합니다.
다른 엔드포인트 선택
사진 없이 새 구도면 Lite 텍스트 생성을 사용합니다. 생성 포토부스는 4프레임 배치를 보여 주지만 편집은 참조 자료에서 시작합니다. 2K·4K가 필요하면 해당 단계의 Nano Banana 2.1을 고릅니다. Lite는 저렴한 1K 옵션이며 원본 자료, 출력 크기, 검증할 세부로 선택합니다.
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/edit",
"input": {
"aspect_ratio": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# 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 레퍼런스에서 확인하세요.







