만들게 될 것
CometAPI를 통해 Gemini 이미지generateContent 라우트를 호출하고, Nano Banana 모델 계열을 포함한 Gemini 이미지 모델에서 이미지 출력을 요청하며, 중간 thought 이미지 파트를 건너뛰고, 최종 inlineData 이미지를 저장하게 됩니다.
사전 준비 사항
COMETAPI_KEY에 저장된 CometAPI API 키requests가 설치된 Python 3.10+ 또는 Node.js 18+- Gemini 이미지 model ID. 유지 관리되는 API 레퍼런스에서는 텍스트-투-이미지 예제로
gemini-3.1-flash-image-preview를 사용합니다.
API 키, 기본 URL, 인증
CometAPI를 통해 Gemini 이미지 라우트를 사용하세요:x-goog-api-key로 인증합니다:
코드 예제
아래 탭에서 cURL, Python, Node.js용으로 바로 복사해 사용할 수 있는 예제를 확인하세요.흐름 설명
이 라우트에서 Gemini 이미지 생성은 동기식으로 처리됩니다. 응답은 Gemini 고유 형식인candidates[].content.parts[]를 사용합니다. parts에는 텍스트, 생성된 이미지, 그리고 thought가 true인 중간 이미지 파트가 포함될 수 있습니다.
결과를 저장할 때는 이미지 파트를 순회하면서 thought: true를 무시하고, 마지막으로 남는 inlineData 이미지를 저장하세요.
공통 파라미터
문제 해결 / FAQ
응답에 thought 이미지가 포함됩니다
응답에 thought 이미지가 포함됩니다
thought가 true인 파트는 저장하지 마세요. 이것들은 최종 출력이 아닌 중간 이미지입니다.요청이 텍스트만 반환합니다
요청이 텍스트만 반환합니다
generationConfig.responseModalities에 IMAGE가 포함되어 있는지, 그리고 선택한 모델이 이미지 출력을 지원하는지 확인하세요.이미지-투-이미지가 필요합니다
이미지-투-이미지가 필요합니다
Gemini 이미지 가이드에 나온 것처럼
inline_data 요청 파트를 사용하고, 최종 이미지 파싱 로직은 동일하게 유지하세요.다음 단계
- Gemini image API 레퍼런스를 읽어보세요.
- Gemini 이미지 모델 사용하기에서 더 많은 예제를 확인하세요.
- Models에서 사용 가능한 이미지 모델을 찾아보세요.
- 모델 호출 전에 요청 비용 추정하기로 비용을 예측하세요.