v1

latestOpenAPI 3.1.02026-07-224941145.6 KB

Image Editing

Edit images using Gemini model.

post/v1beta/models/gemini-2.0-flash:generateContent

Query parameters

keystring required

API Key

Request body

Example request

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Change the background to blue sky with clouds"
        },
        {
          "inline_data": {
            "mime_type": "image/png",
            "data": "BASE64_IMAGE_DATA"
          }
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "IMAGE"
    ]
  }
}

Response

Image edited 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"
}