API
구글 콘텐츠 생성
요약
구글의 Generative AI API는 텍스트 기반 프롬프트에 따라 모델이 생성한 응답을
단일 응답 객체로 완성한 뒤 한 번에 반환합니다. 이 방식은 전체 출력 결과가 생성
완료된 후 제공되므로, 구조화된 응답 처리나 후처리 로직이 필요한 작업에
유리합니다. 요청과 응답의 흐름이 명확하게 구분되어 있어, 단순 콘텐츠 생성,
자동화된 응답 시스템 등 안정적인 일괄 처리 환경에 적합합니다.
- SDK: 구글 SDK 링크
- 공식 문서: 구글 API 공식 문서
| API | 지원 모델 |
|---|---|
| google/models/generate-content | gemini-3-pro-previewgemini-2.5-flashgemini-2.5-pro |
콘텐츠 생성
POST/v1/api/google/models/generate-content
지정한
model과 contents를 기반으로 텍스트 응답을 생성합니다. 이 메서드는 전체 응답을 한 번에 반환하므로, 사용자는 결과가 완성될 때까지 대기한 후 전체 응답을 받을 수 있습니다.보다 자세한 사용법은 텍스트 생성 가이드를 참고하세요.
만약 스트리밍 방식으로 응답을 받고 싶다면
/models/generate-content-stream을
참고해주세요.
요청 헤더
Authorization: Bearer {api-key}
파라미터
modelstring
required
완성 생성에 사용할
Model의 이름입니다.contents[]object
required
모델과의 현재 대화 콘텐츠입니다.
싱글턴 쿼리의 경우 이는 단일 인스턴스입니다. 채팅과 같은 멀티턴 쿼리의 경우 이는 대화 기록과 최근 요청이 포함된 반복 필드입니다.
추가 파라미터
마지막 수정 날짜: Nov 28, 2025