Skip to main content
POST
/
v1beta
/
models
/
gemini-2.5-flash-image:generateContent
gemini-2.5-flash-image (text to image)
curl --request POST \
  --url https://api.example.com/v1beta/models/gemini-2.5-flash-image:generateContent
Gemini’s official format for the text to image API.

​
Supported inputs & outputs :

Inputs: Text Outputs: Text and image 
{
  "error": {
    "message": "Invalid signature",
    "type": "401"
  }
}

​
Parameters

ParameterTypeRequiredDefaultDescription
contentsarray✅ Yes-The prompt for the generation.
generationConfigobject❌ No-The model defaults to returning text and image responses (['Text', 'Image']). You can configure the response to return only images without text using ( ['Image']).
imageConfigobject❌ No-1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9. default 1:1aspectRatioResolution----------------------1:11024x10242:3832x12483:21248x8323:4864x11844:31184x8644:5896x11525:41152x8969:16768x134416:91344x76821:91536x672

​
Response

{
    "candidates": [
        {
            "content": {
                "role": "model",
                "parts": [
                    {
                        "inlineData": {
                            "mimeType": "image/png",
                            "data": "image base64"
                        }
                    }
                ]
            },
            "finishReason": "STOP"
        }
    ],
    "usageMetadata": {
        "promptTokenCount": 16,
        "candidatesTokenCount": 1290,
        "totalTokenCount": 1306,
        "thoughtsTokenCount": 0,
        "promptTokensDetails": [
            {
                "modality": "TEXT",
                "tokenCount": 16
            }
        ]
    },
    "modelVersion": "gemini-2.5-flash-image"
}