Text modelsAdvanced usersUpdated
POST/v1beta/models/gemini-3.1-pro-preview:generateContent

API console

POST/v1beta/models/gemini-3.1-pro-preview:generateContent
View keys

Requests use the API key you enter and follow standard API billing.

Gemini 3.1 Pro

Request ID gemini-3.1-pro-preview

Protocols

Authentication

Requests require an API key from API key management. For JSON requests, set Content-Type: application/json.

  • Gemini · x-goog-api-key: YOUR_API_KEY

Request parameters

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

FieldTypeRequiredDescription
model (path)stringRequiredUse gemini-3.1-pro-preview as the model ID in the URL path.
contentsobject[]RequiredConversation contents in order. Each item holds its input parts in parts.
contents[].rolestringOptionalMessage role. Use user for user input and model for model messages in history.
contents[].partsobject[]RequiredArray of parts within a content item. Text parts use text.
systemInstructionobjectOptionalSystem instruction object. Put instruction text in parts[].text.
generationConfig.maxOutputTokensintegerOptionalCaps output tokens. The accepted limit depends on the model and endpoint.
generationConfig.temperaturenumberConditionalControls sampling randomness. Accepted values and whether the field takes effect depend on the model and endpoint.
generationConfig.topPnumberConditionalLimits sampling candidates by cumulative probability. Use when the model and endpoint support it.
generationConfig.responseMimeTypestringOptionalOutput MIME type. Use application/json for JSON output.
generationConfig.responseJsonSchemaobjectConditionalOutput JSON Schema. Use with responseMimeType: application/json on an endpoint that supports schemas.

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

FieldTypeRequiredDescription
model (path)stringRequiredUse gemini-3.1-pro-preview as the model ID in the URL path.
contentsobject[]RequiredConversation contents in order. Each item holds its input parts in parts.
contents[].rolestringOptionalMessage role. Use user for user input and model for model messages in history.
contents[].partsobject[]RequiredArray of parts within a content item. Text parts use text.
systemInstructionobjectOptionalSystem instruction object. Put instruction text in parts[].text.
generationConfig.maxOutputTokensintegerOptionalCaps output tokens. The accepted limit depends on the model and endpoint.
generationConfig.temperaturenumberConditionalControls sampling randomness. Accepted values and whether the field takes effect depend on the model and endpoint.
generationConfig.topPnumberConditionalLimits sampling candidates by cumulative probability. Use when the model and endpoint support it.
generationConfig.responseMimeTypestringOptionalOutput MIME type. Use application/json for JSON output.
generationConfig.responseJsonSchemaobjectConditionalOutput JSON Schema. Use with responseMimeType: application/json on an endpoint that supports schemas.
?altstringOptionalQuery parameter. Set to sse to receive the streamGenerateContent result as SSE.

Request examples

Set your API key in the local ICODEEASY_API_KEY environment variable and choose an endpoint that accepts direct HTTP calls. For endpoints that require a specific client, follow that client’s setup guide.

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."
        }
      ]
    }
  ]
}'

Read the response

  • Gemini generateContent · Read text parts in candidates[].content.parts[]. JSON
  • Gemini streamGenerateContent · Parse each SSE record and append the text in candidates[].content.parts[]. SSE

Full integration guide

Capabilities and limits

  • streaming · Supported

Compatibility aliases and retired redirects

  • gemini-3.1-pro → gemini-3.1-pro-preview (Alias)
  • gemini-3-pro-preview → gemini-3.1-pro-preview (Retired redirect)

Model Capability Catalog · View pricing

Related guides

Gemini CLI Setup

Install Gemini CLI, configure authentication and the custom service domain, then use strict non-streaming JSON, SSE responses, and the video analysis demo correctly.

Gemini generateContent

Send native Gemini requests and read JSON responses or SSE streams. Put the model ID in the URL path and text in contents[].parts[].

Model Capability Catalog

Compare public text, image, and video models by normalized request ID, compatible protocols, supported clients, tool use, media capabilities, limits, and review date.

Sign up and get an API key