Gemini Generate Content

Gemini Content와 Parts 구조로 텍스트, 멀티모달, 도구 및 코드 실행 응답을 생성합니다.

Generate Content API는 Content와 Parts로 텍스트, 멀티모달, 함수 호출 및 코드 실행 요청을 표현하고 Candidates, Usage Metadata 및 안전 정보로 생성 결과를 반환합니다. 요청에는 Bearer API 키 인증을 사용합니다. 지원하는 입력 모달리티, 도구 및 고급 생성 매개변수는 모델마다 다를 수 있으므로 현재 계정에 표시되는 모델과 공식 기능 설명을 기준으로 하세요.

POST/v1beta/models/{model}:generateContent

Gemini Content와 Parts 구조로 텍스트, 멀티모달, 함수 호출 또는 코드 실행 응답을 생성합니다.

인증

bearerAuth

인증Bearer <token>

Authorization Header에 Bearer your-api-key를 사용합니다.

전달 위치: header

경로 매개변수

model*string

콘텐츠 생성에 사용할 모델 ID입니다. 경로는 자동으로 models/{model}로 구성됩니다.

기본값"MODEL_ID"

요청 본문

Gemini는 Content와 Parts로 텍스트, 멀티모달, 도구 및 생성 설정을 표현합니다.

application/json

텍스트 대화

user와 model Content로 단일 턴 또는 여러 턴 텍스트 대화를 구성합니다.

contents[]: 순서대로 정렬한 대화 콘텐츠입니다.
parts[].text: 각 메시지의 텍스트 콘텐츠입니다.
role: 메시지 생성 주체입니다. 일반적인 값은 user 또는 model입니다.

application/json

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "안녕하세요! 자신을 소개해 주세요."
        }
      ]
    }
  ]
}

Content와 text Part로 단일 턴 또는 여러 턴 텍스트 대화를 구성합니다.

contents*array<>

순서대로 정렬한 텍스트 Content입니다. 각 메시지는 parts[].text로 콘텐츠를 제공합니다.

항목1 <= items

tools?array<>

모델에서 사용할 함수, 코드 실행, 검색, URL Context, File Search, MCP 등의 도구입니다.

toolConfig?

요청에서 도구 호출을 설정합니다.

safetySettings?array<>

안전 유형별 콘텐츠 차단 임계값을 설정합니다.

systemInstruction?

개발자가 설정한 시스템 지시이며 현재는 텍스트 콘텐츠만 지원합니다.

generationConfig?

모델 생성 및 출력 설정입니다.

cachedContent?string

컨텍스트로 사용할 캐시 콘텐츠 이름이며 형식은 cachedContents/{cachedContent}입니다.

serviceTier?ServiceTier

요청에서 사용한 서비스 등급입니다.

허용 값

"unspecified"
"standard"
"flex"
"priority"

store?boolean

현재 요청의 로그 기록 동작을 제어합니다. 설정하면 프로젝트 수준 로그 설정보다 우선합니다.

응답 본문

`application/json`

curl -X POST "https://example.com/v1beta/models/MODEL_ID:generateContent" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "안녕하세요! 자신을 소개해 주세요."
          }
        ]
      }
    ]
  }'

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "안녕하세요! 질문에 답하고 작업을 도와드리는 AI 도우미입니다."
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP",
      "index": 0,
      "safetyRatings": [
        {
          "category": "HARM_CATEGORY_HARASSMENT",
          "probability": "NEGLIGIBLE",
          "blocked": false
        }
      ],
      "tokenCount": 24
    }
  ],
  "promptFeedback": {
    "safetyRatings": [
      {
        "category": "HARM_CATEGORY_HARASSMENT",
        "probability": "NEGLIGIBLE"
      }
    ]
  },
  "usageMetadata": {
    "promptTokenCount": 8,
    "candidatesTokenCount": 24,
    "totalTokenCount": 32,
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 8
      }
    ],
    "candidatesTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 24
      }
    ]
  },
  "modelVersion": "MODEL_ID",
  "responseId": "response-example"
}

Google Gemini Generate Content 공식 문서상위 프로토콜 정의 및 최신 필드 변경 사항을 확인합니다.

인증

경로 매개변수

요청 본문

응답 본문

200application/json

400application/json

401application/json

403application/json

404application/json

413application/json

429application/json

500application/json

503application/json

504application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`