업데이트: 2026-06-06

Gemini 이미지 생성

POST /v1/images/generations

Crazyrouter는 Gemini 이미지 모델에 대해 통합 OpenAI Images 호환 엔드포인트를 제공합니다. 사용자는 Gemini 네이티브 generateContent를 직접 호출할 필요가 없으며, Gemini 네이티브 generationConfig.imageConfig를 전달할 필요도 없습니다.

권장 공개 모델명	호환 하위 모델명
`nano-banana`	`nano-banana`
`nano-banana-pro`	`nano-banana-pro`
`nano-banana-2`	`nano-banana-2`

Gemini 이미지 생성은 장시간 요청에 해당합니다. 프로덕션 연동 시 주 수신 라인인 https://api.crazyrouter.com/v1을 우선 사용하세요. 전체 생성 엔드포인트는 https://api.crazyrouter.com/v1/images/generations입니다.

클라이언트 코드에서는 nano-banana, nano-banana-pro, nano-banana-2를 사용하는 것을 권장합니다. 시스템에서 이미 nano-banana, nano-banana-pro, nano-banana-2를 직접 사용하고 있다면, 동일한 Images API 엔드포인트를 통해 계속 호출할 수 있습니다.

요청 파라미터

파라미터	타입	필수	설명
`model`	string	예	`nano-banana`, `nano-banana-pro`, `nano-banana-2` 또는 해당 Gemini canonical 명칭
`prompt`	string	예	생성 또는 편집 지시문
`image_input`	string 또는 string[]	아니오	참조 이미지 URL; 전달하지 않으면 텍스트-투-이미지로 처리
`resolution`	string	아니오	`1K`, `2K`, `4K`
`aspect_ratio`	string	아니오	예: `1:1`, `16:9`, `9:16`, `21:9`, `auto`
`output_format`	string	아니오	`png`, `jpeg` / `jpg`
`output_compression`	integer	아니오	`0-100`, JPEG 압축 품질에 사용
`n`	integer	아니오	생성 수량, 기본값 `1`

다음과 같은 상위 전용 필드는 전달하지 마세요: generationConfig, imageConfig, imageOutputOptions, image_output_options.

요청 예제

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-2",
    "prompt": "A simple red square on a white background, clean vector style",
    "resolution": "1K",
    "aspect_ratio": "1:1",
    "output_format": "png"
  }'

응답은 OpenAI Images 스타일을 유지합니다.

{
  "created": 1778990000,
  "data": [
    {
      "url": "https://media.crazyrouter.com/task-artifacts/2026/05/17/sync-image/request-id-1.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": "참조 이미지를 고급 이커머스 포스터로 바꿔줘, 주체는 유지하고 배경은 더 깔끔하게",
    "image_input": [
      "https://example.com/reference.png"
    ],
    "resolution": "1K",
    "aspect_ratio": "1:1",
    "output_format": "jpeg",
    "output_compression": 85
  }'

Gemini 네이티브 API 형태가 반드시 필요하다면 Gemini 네이티브 형식을 참고하세요. 다만 이미지 생성 및 편집의 경우, 클라이언트 측에서는 이 페이지의 Images API를 통합적으로 사용하는 것을 권장합니다.

Chat - OpenAI

Chat - Claude

Chat - Gemini

Chat - Responses API

이미지 생성

비디오 생성

오디오

임베딩 & 리랭킹

기타 API

레퍼런스

Gemini 이미지 생성

Gemini 이미지 생성

요청 파라미터

요청 예제

참조 이미지 편집

​Gemini 이미지 생성

​요청 파라미터

​요청 예제

​참조 이미지 편집

Gemini 이미지 생성

요청 파라미터

요청 예제

참조 이미지 편집