Gemini content

Generates a model response given an input using Google Gemini models. Supports text chat and image generation capabilities.

How To Use

Simply specify the model name in your request payload. All other parameters remain the same across different models.

Supported Models

Text/Chat Models

gemini-3-flash-preview

Image Generation Models

gemini-2.5-flash-image

gemini-3-pro-image-preview

Authentication

Use x-goog-api-key header for authentication.

Image Generation

For image generation, set generationConfig.responseModalities to ["image", "text"].

Request

Authorization

API Key

Add parameter in header

x-goog-api-key

Example:

x-goog-api-key: ********************

Path Params

Body Params application/jsonRequired

Examples

Simple text generationWith system instructionMulti-turn conversationImage generation

{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "Hi, what model are you?"
                }
            ]
        }
    ],
    "generationConfig": {
        "temperature": 0.7,
        "maxOutputTokens": 1024
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Content generated successfully

Bodyapplication/json

Example

{
    "candidates": [
        {
            "content": {
                "parts": [
                    {
                        "text": "I am Gemini, a large language model created by Google."
                    }
                ],
                "role": "model"
            },
            "finishReason": "STOP",
            "index": 0,
            "safetyRatings": [
                {
                    "category": "HARM_CATEGORY_SEXUALLY_EXPLICIT",
                    "probability": "NEGLIGIBLE"
                },
                {
                    "category": "HARM_CATEGORY_HATE_SPEECH",
                    "probability": "NEGLIGIBLE"
                },
                {
                    "category": "HARM_CATEGORY_HARASSMENT",
                    "probability": "NEGLIGIBLE"
                },
                {
                    "category": "HARM_CATEGORY_DANGEROUS_CONTENT",
                    "probability": "NEGLIGIBLE"
                }
            ]
        }
    ],
    "usageMetadata": {
        "promptTokenCount": 6,
        "candidatesTokenCount": 12,
        "totalTokenCount": 18
    },
    "modelVersion": "gemini-2.5-flash"
}

🟠400Bad Request

🟠401Unauthorized

🟠429Too Many Requests

🔴500Internal Server Error

How To Use#

Supported Models#

Text/Chat Models#

Image Generation Models#

Authentication#

Image Generation#