Gemini 3.1 Pro

요청 ID gemini-3.1-pro-preview

프로토콜

POST /v1beta/models/gemini-3.1-pro-preview:generateContent · Gemini generateContent 예시
POST /v1beta/models/gemini-3.1-pro-preview:streamGenerateContent · Gemini streamGenerateContent 예시

인증

요청에는 API 키 관리의 API 키가 필요합니다. JSON 요청은 Content-Type: application/json을 지정하세요.

Gemini · x-goog-api-key: YOUR_API_KEY

요청 매개변수

`POST /v1beta/models/gemini-3.1-pro-preview:generateContent`

필드	유형	필수 여부	설명
`model (path)`	`string`	필수	URL 경로의 모델 ID에 `gemini-3.1-pro-preview`를 사용하세요.
`contents`	`object[]`	필수	대화 내용을 순서대로 보냅니다. 각 항목의 입력 조각은 `parts`에 넣습니다.
`contents[].role`	`string`	선택	메시지 역할입니다. 사용자 입력은 `user`, 이전 모델 메시지는 `model`을 사용합니다.
`contents[].parts`	`object[]`	필수	콘텐츠 항목 안의 부분 배열입니다. 텍스트 부분에는 `text`를 사용합니다.
`systemInstruction`	`object`	선택	시스템 지침 객체입니다. 지침 텍스트를 `parts[].text`에 넣습니다.
`generationConfig.maxOutputTokens`	`integer`	선택	출력 토큰 수의 상한입니다. 허용 범위는 모델과 엔드포인트에 따라 다릅니다.
`generationConfig.temperature`	`number`	조건부	샘플링의 무작위성을 조절합니다. 허용값과 적용 여부는 모델 및 엔드포인트에 따라 다릅니다.
`generationConfig.topP`	`number`	조건부	누적 확률로 샘플링 후보를 제한합니다. 모델과 엔드포인트에서 지원할 때 사용하세요.
`generationConfig.responseMimeType`	`string`	선택	출력 MIME 유형입니다. JSON 출력에는 `application/json`을 사용합니다.
`generationConfig.responseJsonSchema`	`object`	조건부	출력 JSON Schema입니다. 스키마를 지원하는 엔드포인트에서 `responseMimeType: application/json`과 함께 사용하세요.

`POST /v1beta/models/gemini-3.1-pro-preview:streamGenerateContent`

필드	유형	필수 여부	설명
`model (path)`	`string`	필수	URL 경로의 모델 ID에 `gemini-3.1-pro-preview`를 사용하세요.
`contents`	`object[]`	필수	대화 내용을 순서대로 보냅니다. 각 항목의 입력 조각은 `parts`에 넣습니다.
`contents[].role`	`string`	선택	메시지 역할입니다. 사용자 입력은 `user`, 이전 모델 메시지는 `model`을 사용합니다.
`contents[].parts`	`object[]`	필수	콘텐츠 항목 안의 부분 배열입니다. 텍스트 부분에는 `text`를 사용합니다.
`systemInstruction`	`object`	선택	시스템 지침 객체입니다. 지침 텍스트를 `parts[].text`에 넣습니다.
`generationConfig.maxOutputTokens`	`integer`	선택	출력 토큰 수의 상한입니다. 허용 범위는 모델과 엔드포인트에 따라 다릅니다.
`generationConfig.temperature`	`number`	조건부	샘플링의 무작위성을 조절합니다. 허용값과 적용 여부는 모델 및 엔드포인트에 따라 다릅니다.
`generationConfig.topP`	`number`	조건부	누적 확률로 샘플링 후보를 제한합니다. 모델과 엔드포인트에서 지원할 때 사용하세요.
`generationConfig.responseMimeType`	`string`	선택	출력 MIME 유형입니다. JSON 출력에는 `application/json`을 사용합니다.
`generationConfig.responseJsonSchema`	`object`	조건부	출력 JSON Schema입니다. 스키마를 지원하는 엔드포인트에서 `responseMimeType: application/json`과 함께 사용하세요.
`?alt`	`string`	선택	쿼리 매개변수입니다. `sse`를 지정하면 `streamGenerateContent` 결과를 SSE로 받습니다.

요청 예시

API Key를 로컬 환경 변수 ICODEEASY_API_KEY에 설정하고 직접 HTTP 호출을 허용하는 엔드포인트를 선택하세요. 특정 클라이언트가 필요한 경우 해당 설정 가이드를 따르세요.

Gemini generateContent

bash

curl -sS 'https://api.icodeeasy.cc/v1beta/models/gemini-3.1-pro-preview:generateContent' \
  -H "x-goog-api-key: $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Explain how a rainbow forms in one sentence."
        }
      ]
    }
  ]
}'

Gemini streamGenerateContent

bash

curl -N -sS 'https://api.icodeeasy.cc/v1beta/models/gemini-3.1-pro-preview:streamGenerateContent?alt=sse' \
  -H "x-goog-api-key: $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Explain how a rainbow forms in one sentence."
        }
      ]
    }
  ]
}'

응답 읽기

Gemini generateContent · candidates[].content.parts[]에서 텍스트를 읽으세요. JSON
Gemini streamGenerateContent · 각 SSE 레코드를 파싱하고 candidates[].content.parts[]의 텍스트를 연결하세요. SSE

전체 연동 가이드