Gemini 3.1 Flash Image 기반 Nano Banana 2의 편집 엔드포인트입니다. 해상도 제어(1K/2K/4K), Google 검색 연동, 사고 모드를 추가하면서 대화형 편집과 멀티 이미지 융합을 유지합니다.
콘솔의 Playground에서 별도 코드 없이 이 모델을 즉시 테스트할 수 있어요
이 모델의 사용법을 Claude, ChatGPT 등에 복사
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "fal-ai/nano-banana-2/edit",
"input": {
"prompt": "make a photo of the man driving the car down the california coastline",
"image_urls": [
"https://storage.googleapis.com/falserverless/example_inputs/nano-banana-edit-input.png",
"https://storage.googleapis.com/falserverless/example_inputs/nano-banana-edit-input-2.png"
],
"aspect_ratio": "auto",
"resolution": "1K",
"output_format": "png",
"num_images": 1
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
prompt | string | Yes | - | 이미지 편집 방식 |
num_images | integer | No | 1 | 생성할 이미지 수 |
seed | integer | No | - | 난수 생성기용 시드. |
aspect_ratio | string | No | auto | 출력 비율 (auto는 모델이 자동 결정) auto21:916:93:24:35:41:14:53:42:39:164:11:48:11:8 |
output_format | string | No | png | 출력 이미지 포맷 jpegpngwebp |
safety_tolerance | string | No | 4 | 콘텐츠 검열의 안전 허용 수준. 1이 가장 엄격(대부분 차단)하고 6이 가장 관대함. 123456 |
sync_mode | boolean | No | false | `True`이면 미디어가 data URI로 반환되며, 출력 데이터는 요청 기록에서 확인할 수 없습니다. |
image_urls | array | No | - | 편집할 입력 이미지 URL 배열 |
system_prompt | string | No | - | 요청 전반에서 모델의 페르소나와 출력 스타일을 지정하는 선택적 시스템 지시문. 비워두면 생략되며, 지정하면 Gemini의 시스템 지시문(또는 OpenAI 호환 프로바이더의 시스템 메시지)으로 전달됩니다. |
resolution | string | No | 1K | 출력 해상도 — 해상도에 따라 가격이 달라집니다 0.5K1K2K4K |
video_url | string | No | - | 입력 컨텍스트로 사용할 선택적 비디오. 비디오 파일의 http(s)/data URL(다운로드 후 인라인 전송, 최대 15MB) 또는 YouTube URL(다운로드 없이 모델로 그대로 전달)을 지원합니다. |
audio_url | string | No | - | 입력 컨텍스트로 사용할 선택적 오디오 파일. http(s)/data URL을 지원 (다운로드 후 인라인 전송, 최대 15MB). |
pdf_url | string | No | - | 입력 컨텍스트로 사용할 선택적 PDF 문서. http(s)/data URL을 지원 (다운로드 후 인라인 전송, 최대 15MB). |
limit_generations | boolean | No | true | 매 프롬프팅 라운드의 생성 개수를 1개로 제한하는 실험적 파라미터. `True`로 설정하면 프롬프트에 포함된 생성 이미지 개수 지시를 무시하고 모델이 생성한 중간 이미지도 무시합니다. 생성 품질에 영향을 줄 수 있습니다. |
enable_web_search | boolean | No | false | 실시간 정보를 위한 웹 검색 연동 |
thinking_level | string | No | - | 모델 사고 모드 활성화 (생략 시 비활성) minimalhigh |
이 모델의 image_urls 파라미터에 파일을 전달하는 방법은 3가지입니다.
POST /v1/predictions/upload에 파일을 직접 첨부합니다. 별도 업로드 과정이 필요 없습니다.
curl -X POST "https://api.core.today/v1/predictions/upload" \
-H "X-API-Key: cdt_your_api_key" \
-F "model=fal-ai/nano-banana-2/edit" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:image_urls=@your_file.png"공개 접근 가능한 URL을 직접 전달합니다. Storage API로 업로드한 파일의 file_url도 사용 가능합니다.
{
"model": "fal-ai/nano-banana-2/edit",
"input": {
"prompt": "your prompt here",
"image_urls": ["https://example.com/image.jpg"]
}
}POST /v1/predictions 요청 시 사용되는 공통 파라미터입니다.
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
model | string | Yes | - | 모델 식별자 |
input | object | Yes | - | 위 테이블의 모델별 파라미터를 포함하는 객체 |
output_folder | string | No | - | 결과물 저장 폴더 경로 (최대 256자, '..' 사용 불가) |
webhook_url | string | No | - | 완료 시 호출할 Webhook URL |
is_public | boolean | No | false | true 시 결과물을 영구 공개 URL로도 제공 |
여러 입력 사진을 합성하여 장면 구성
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "fal-ai/nano-banana-2/edit",
"input": {
"prompt": "make a photo of the man driving the car down the california coastline",
"image_urls": [
"https://storage.googleapis.com/falserverless/example_inputs/nano-banana-edit-input.png",
"https://storage.googleapis.com/falserverless/example_inputs/nano-banana-edit-input-2.png"
],
"aspect_ratio": "auto",
"resolution": "1K",
"output_format": "png",
"num_images": 1
}
}'