POST
/
v1beta
/
models
/
gemini-2.5-flash-image:generateContent
curl -X POST "https://api.example.com/v1beta/models/gemini-2.5-flash-image:generateContent?key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {"text": "Generate a beautiful sunset over mountains"}
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["IMAGE"],
      "responseMimeType": "image/png"
    }
  }'

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "inline_data": {
              "mime_type": "image/png",
              "data": "base64_encoded_image"
            }
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP"
    }
  ]
}
Official documentation: https://ai.google.dev/gemini-api/docs/image-generation
Generate images using Google Gemini 2.5 Flash Image model.

​
Request Parameters

​
key
string
required
API key.
​
contents
array
required
Content array containing text prompts and optional reference images.Each content object contains:
  • role (string): Role
  • parts (array): Content parts, can include text and images
​
generationConfig
object
Generation configuration.
  • responseModalities (array): Response modalities, e.g., ["TEXT", "IMAGE"]
  • responseMimeType (string): Response MIME type

​
Image Input Format

{
  "inline_data": {
    "mime_type": "image/jpeg",
    "data": "base64_encoded_image_data"
  }
}

curl -X POST "https://api.example.com/v1beta/models/gemini-2.5-flash-image:generateContent?key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {"text": "Generate a beautiful sunset over mountains"}
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["IMAGE"],
      "responseMimeType": "image/png"
    }
  }'

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "inline_data": {
              "mime_type": "image/png",
              "data": "base64_encoded_image"
            }
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP"
    }
  ]
}