업데이트: 2026-09-18

​

Nano Banana Pro

POST /v1/images/generations

​

이 페이지에서 다루는 내용

• 이 페이지는 nano-banana-pro / nano-banana-pro만 다룹니다
• 클라이언트 요청 진입점은 통일적으로 POST /v1/images/generations입니다
• 입력 이미지 필드는 통일적으로 image_input입니다
• 기본 공개 프로토콜은 여전히 image_input URL 사용을 권장합니다. 지정된 그레이 릴리스 계정에는 dataURL, raw Base64 및 3장 multipart 이미지 편집이 추가로 지원됩니다
• data: / Base64 / multipart는 Crazyrouter의 호환 확장 기능이며, 모든 업스트림 carrier가 네이티브로 지원한다는 의미는 아닙니다
• 백엔드는 Gemini / Vertex 등의 provider일 수 있지만, 이러한 provider의 세부 사항은 클라이언트 프로토콜의 일부가 아닙니다
• 사용자 측에서는 generationConfig, imageConfig, imageOutputOptions, image_output_options를 전달하지 마십시오. 이러한 필드는 Crazyrouter가 통합 파라미터로부터 자동으로 변환합니다

​

모델명

​

기능 상태

​

현재 검증된 기능

• 공식 Vertex 채널 318 (vertexsophie) 직접 연결에서 검증됨:
  • 2장 참조 이미지 사용 가능
• 로컬 4000 포트, 고정 채널 318에서 검증됨:
  • 단일 WEBP URL 참조 이미지 사용 가능
  • 단일 JPEG URL 참조 이미지 사용 가능
  • 2장 PNG URL 참조 이미지 사용 가능
  • resolution: "1K" 사용 가능
  • resolution: "4K" 사용 가능
  • aspect_ratio: "1:1" 사용 가능
  • aspect_ratio: "21:9" 사용 가능
  • output_format: "png" 사용 가능
  • output_format: "jpg" 사용 가능
• 응답은 data[].url을 직접 반환할 수 있습니다

• /v1/images/generations의 image_input은 dataURL, raw Base64 및 다중 이미지 입력을 지원합니다
• /v1/images/edits는 multipart의 image, image[], image[n]을 지원합니다
• 원본 이미지, 주석 이미지, 참조 이미지는 업로드 순서에 따라 3장 편집 요청을 구성할 수 있습니다

• 정확한 다중 이미지 상한이 8인지 그 이상인지
• 2K
• 정확한 대용량 파일 URL 상한
• 정확한 30 MiB 경계
• 기타 aspect_ratio 조합
• output_compression의 정확한 의미 경계

​

요청 파라미터

​

다중 이미지 현재 상태

• 2장: 검증됨
• 11257 그레이 릴리스 3장: 검증됨
• 더 높은 수량: 업스트림의 정확한 최댓값은 아직 추가 테스트가 필요하며, 현재는 보장하지 않습니다

​

라우팅 설명

• 단일 이미지 요청은 일반적인 사용 가능 carrier에 도달할 수 있습니다
• 기본 다중 이미지 요청은 공식 Gemini / Vertex carrier로만 라우팅됩니다. 지정된 그레이 릴리스 계정은 이미 검증된 그레이 릴리스 carrier를 사용할 수 있습니다
• 이는 서버 측 내부 라우팅 정책이며, 클라이언트 프로토콜은 변경되지 않습니다

​

그레이 릴리스 3장 multipart

curl -X POST https://api.crazyrouter.com/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=nano-banana-pro" \
  -F "prompt=첫 번째 이미지를 원본으로, 두 번째 이미지를 주석 이미지로, 세 번째 이미지를 참조 이미지로 사용하여 주석 영역만 수정" \
  -F "image[]=@original.png" \
  -F "image[]=@annotation.png" \
  -F "image[]=@reference.png"

​

요청 예시

​

단일 이미지 편집

curl -X POST https://api.crazyrouter.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "nano-banana-pro",
    "prompt": "이 상품 이미지를 초와이드 배너 KV로 바꾸고, 배경을 더 깔끔하게 하되 주체 구조는 유지",
    "image_input": [
      "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/fpakfo/image36.webp"
    ],
    "resolution": "4K",
    "aspect_ratio": "21:9",
    "output_format": "png"
  }'

import requests

response = requests.post(
    "https://api.crazyrouter.com/v1/images/generations",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer YOUR_API_KEY"
    },
    json={
        "model": "nano-banana-pro",
        "prompt": "이 상품 이미지를 초와이드 배너 KV로 바꾸고, 배경을 더 깔끔하게 하되 주체 구조는 유지",
        "image_input": [
            "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/fpakfo/image36.webp"
        ],
        "resolution": "4K",
        "aspect_ratio": "21:9",
        "output_format": "png"
    }
)

data = response.json()
print(data["data"][0]["url"])

​

텍스트로 이미지 생성

curl -X POST https://api.crazyrouter.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "nano-banana-pro",
    "prompt": "A premium product poster for a red apple, studio lighting, clean background",
    "resolution": "1K",
    "aspect_ratio": "1:1",
    "output_format": "jpeg",
    "output_compression": 85
  }'

​

2장 참조 이미지

{
  "model": "nano-banana-pro",
  "prompt": "두 장의 참조 이미지의 주체와 구도를 융합하여, 고품질 메인 비주얼 이미지 한 장을 생성",
  "image_input": [
    "https://example.com/ref-1.png",
    "https://example.com/ref-2.png"
  ],
  "resolution": "1K",
  "aspect_ratio": "1:1"
}

​

응답 예시

{
  "created": 1774846705,
  "data": [
    {
      "url": "https://media.crazyrouter.com/task-artifacts/2026/03/30/sync-image/20260331073825672515332JyP6hAcs-1.png"
    }
  ]
}

​

검증된 결과 요약

​

현재 알려진 제한 사항

• 그레이 릴리스 계정이 아닌 경우 image, data: / Base64 또는 multipart 이미지 입력을 받지 않습니다
• 그레이 릴리스 계정은 현재 3장까지 검증되었으며, 더 높은 수량 상한은 보장하지 않습니다
• 현재 문서는 정확한 30 MiB URL 경계를 보장하지 않습니다
• 현재 문서는 스크린샷에 나열된 모든 비율 및 파라미터가 완전히 검증되었다고 보장하지 않습니다