Skip to main content
Google빠름높음

Nano Banana (Edit)

Google Gemini 2.5 Flash 기반 Nano Banana의 전용 편집 엔드포인트입니다. 이미지 URL을 입력하면 캐릭터 일관성과 멀티 이미지 융합을 통한 대화형 편집을 수행합니다.

117 크레딧
이미지당
이미지 입력에 최적화된 편집 전용 엔드포인트
캐릭터 일관성 기반 멀티모달 편집
멀티 이미지 융합
대화형 편집 지시
다양한 화면 비율 지원

지금 바로 실행해보세요

콘솔의 Playground에서 별도 코드 없이 이 모델을 즉시 테스트할 수 있어요

로그인 후 사용해보기

AI 어시스턴트에서 사용하기

이 모델의 사용법을 Claude, ChatGPT 등에 복사

llms.txt

빠른 시작

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/edit",
  "input": {
    "prompt": "Make the colors more vibrant and add a sunset glow",
    "image_urls": [
      "https://example.com/input-image.jpg"
    ],
    "aspect_ratio": "match_input_image",
    "output_format": "png",
    "safety_tolerance": "2",
    "num_images": 1
  }
}'

파라미터

파라미터타입필수기본값설명
promptstringYes-이미지 편집 방식
image_urlsarrayYes-편집할 입력 이미지 URL 배열 (편집 모드 필수)
aspect_ratiostringNomatch_input_image출력 비율
match_input_image1:12:33:23:44:34:55:49:1616:921:9
output_formatstringNopng출력 이미지 포맷
pngjpg
safety_tolerancestringNo2안전 허용 수준 (1 가장 엄격, 6 가장 관대)
123456
num_imagesintegerNo1생성할 이미지 수

파일 입력 방법

이 모델의 image_urls 파라미터에 파일을 전달하는 방법은 3가지입니다.

추천

간편 업로드 (Multipart)

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/edit" \
  -F 'input={"prompt":"your prompt here"}' \
  -F "file:image_urls=@your_file.png"

이미지 URL 전달

공개 접근 가능한 URL을 직접 전달합니다. Storage API로 업로드한 파일의 file_url도 사용 가능합니다.

{
  "model": "fal-ai/nano-banana/edit",
  "input": {
    "prompt": "your prompt here",
    "image_urls": ["https://example.com/image.jpg"]
  }
}
File Upload 문서에서 Presigned URL 방식 등 더 자세한 업로드 방법을 확인하세요.

공통 파라미터

POST /v1/predictions 요청 시 사용되는 공통 파라미터입니다.

파라미터타입필수기본값설명
modelstringYes-모델 식별자
inputobjectYes-위 테이블의 모델별 파라미터를 포함하는 객체
output_folderstringNo-결과물 저장 폴더 경로 (최대 256자, '..' 사용 불가)
webhook_urlstringNo-완료 시 호출할 Webhook URL
is_publicbooleanNofalsetrue 시 결과물을 영구 공개 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/edit",
  "input": {
    "prompt": "Make the colors more vibrant and add a sunset glow",
    "image_urls": [
      "https://example.com/input-image.jpg"
    ],
    "aspect_ratio": "match_input_image",
    "output_format": "png",
    "safety_tolerance": "2",
    "num_images": 1
  }
}'

팁 & 모범 사례

1편집할 입력 이미지가 있을 때 이 엔드포인트를 사용하세요
2여러 이미지에서 피사체를 융합하려면 image_urls에 여러 URL을 전달하세요
3match_input_image는 원본 비율을 유지합니다
4순수 텍스트→이미지 생성은 google/nano-banana 모델을 사용하세요

사용 사례

대화형 사진 보정
브랜드 일관성 캐릭터 변형
멀티 이미지 장면 합성
반복 편집 워크플로우