Gemini 3 Pro

by google · family gemini

Facts

Release date	2025-11-18
Retired date	—
Knowledge cutoff	2025-01-31
Context (max)	1,048,576
Max output	65,536
Modalities	text, image → text
Aliases	`gemini-3-pro-preview`
Open weights	no
Description	Uses thinkingLevel (low/high); cannot disable thinking.

Unknown values are shown as —.

Intelligence Index v4.1.1: 41 · Gemini 3 Pro Preview (high) · Source: Artificial Analysis (accessed 2026-08-20)

Offerings

Provider	Wire ID	Variant	Endpoint	Protocol	Status	Price (USD / Mtok)	Reasoning
Google Gemini API	`gemini-3-pro-preview`	pro	generate-content	google-generate-content	preview	2.00 / 12.00	effort · default on · mandatory · returns thought_parts · round-trips thought_signature
Google Vertex AI	`gemini-3-pro-preview`	pro	generate-content	google-generate-content	preview	2.00 / 12.00	effort · default on · mandatory · returns thought_parts · round-trips thought_signature

Reasoning controls

Google Gemini API· gemini-3-pro-preview· generate-content effort

generationConfig.thinkingConfig.thinkingLevel lowhigh●

effort · default on · mandatory · returns thought_parts · round-trips thought_signature

Google Vertex AI· gemini-3-pro-preview· generate-content effort

generationConfig.thinkingConfig.thinkingLevel lowhigh●

effort · default on · mandatory · returns thought_parts · round-trips thought_signature

Example requests

Google Gemini API · google-generate-content · gemini-3-pro-preview

curl 'https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-preview:generateContent' \
  -H 'Content-Type: application/json' \
  -H 'x-goog-api-key: <YOUR_API_KEY>' \
  -d '{
  "contents": [
    {
      "parts": [
        {
          "text": "Tell me about the weather."
        }
      ]
    }
  ],
  "generationConfig": {
    "thinkingConfig": {
      "thinkingLevel": "high"
    }
  }
}'

Python (requests)

import requests

resp = requests.post(
    "https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-preview:generateContent",
    headers={
      "Content-Type": "application/json",
      "x-goog-api-key": "<YOUR_API_KEY>"
    },
    json={
      "contents": [
        {
          "parts": [
            {
              "text": "Tell me about the weather."
            }
          ]
        }
      ],
      "generationConfig": {
        "thinkingConfig": {
          "thinkingLevel": "high"
        }
      }
    },
)
print(resp.json())

TypeScript (fetch)

const resp = await fetch("https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-preview:generateContent", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-goog-api-key": "<YOUR_API_KEY>"
  },
  body: JSON.stringify({
    "contents": [
      {
        "parts": [
          {
            "text": "Tell me about the weather."
          }
        ]
      }
    ],
    "generationConfig": {
      "thinkingConfig": {
        "thinkingLevel": "high"
      }
    }
  }),
})
console.log(await resp.json())

⚠ Responses include thought_signature artifacts — pass them back unmodified on subsequent turns (dropping them triggers 400s or quality loss).

Google Vertex AI · google-generate-content · gemini-3-pro-preview

curl 'https://{region}-aiplatform.googleapis.com/v1/projects/{project}/locations/{region}/publishers/google/models/gemini-3-pro-preview:generateContent' \
  -H 'Authorization: Bearer <YOUR_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
  "contents": [
    {
      "parts": [
        {
          "text": "Tell me about the weather."
        }
      ]
    }
  ],
  "generationConfig": {
    "thinkingConfig": {
      "thinkingLevel": "high"
    }
  }
}'

Python (requests)

import requests

resp = requests.post(
    "https://{region}-aiplatform.googleapis.com/v1/projects/{project}/locations/{region}/publishers/google/models/gemini-3-pro-preview:generateContent",
    headers={
      "Authorization": "Bearer <YOUR_API_KEY>",
      "Content-Type": "application/json"
    },
    json={
      "contents": [
        {
          "parts": [
            {
              "text": "Tell me about the weather."
            }
          ]
        }
      ],
      "generationConfig": {
        "thinkingConfig": {
          "thinkingLevel": "high"
        }
      }
    },
)
print(resp.json())

TypeScript (fetch)

const resp = await fetch("https://{region}-aiplatform.googleapis.com/v1/projects/{project}/locations/{region}/publishers/google/models/gemini-3-pro-preview:generateContent", {
  method: "POST",
  headers: {
    "Authorization": "Bearer <YOUR_API_KEY>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "contents": [
      {
        "parts": [
          {
            "text": "Tell me about the weather."
          }
        ]
      }
    ],
    "generationConfig": {
      "thinkingConfig": {
        "thinkingLevel": "high"
      }
    }
  }),
})
console.log(await resp.json())

⚠ Responses include thought_signature artifacts — pass them back unmodified on subsequent turns (dropping them triggers 400s or quality loss).