Sign in

v1

latestOpenAPI 3.1.02026-07-224941145.6 KB

Generate Content

Generates a model response given an input GenerateContentRequest.

post/v1beta/models/{model}:generateContent

Path parameters

model'gemini-3.1-pro-preview' | 'gemini-3.1-flash-image' | 'gemini-3.1-flash-lite-preview' | 'gemini-3-pro-preview' | 'gemini-3-pro-image' | 'gemini-3-flash-preview' | 'gemini-2.5-pro' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | 'gemini-2.0-flash' required

The model name to use for generation.

Request body

Example request

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Hello, Gemini!"
        }
      ]
    }
  ]
}

Response

Content generated successfully

modelVersionstring
responseIdstring
quotainteger

AnyFast quota usage reported for the request.

Example response

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "inlineData": {
              "mimeType": "image/jpeg"
            },
            "fileData": {
              "mimeType": "application/pdf"
            },
            "executableCode": {
              "language": "PYTHON"
            },
            "codeExecutionResult": {
              "outcome": "OUTCOME_OK"
            }
          }
        ]
      },
      "finishReason": "STOP"
    }
  ],
  "usageMetadata": {
    "serviceTier": "standard",
    "promptTokensDetails": [
      {
        "modality": "TEXT"
      }
    ],
    "toolUsePromptTokensDetails": [
      {
        "modality": "TEXT"
      }
    ]
  },
  "modelVersion": "gemini-3.6-flash"
}