Generate Image

POST

/v1beta/models/{model-name}:generateContent

Use Google's Image-to-Image model: gemini-2.5-flash-image-preview
If you need to support different parameters of official images (such as aspect ratio), please use Google Grouping for tokens.

Request

Path Params

Query Params

Header Params

Body Params application/json

Example

{
  "contents": [
    {
      "parts": [
        {
          "text": "draw a cat"
        }
      ]
    }
  ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --globoff '/v1beta/models/:generateContent?key={{YOUR_API_KEY}}' \
--header 'Authorization: Bearer  {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
  "contents": [
    {
      "parts": [
        {
          "text": "draw a cat"
        }
      ]
    }
  ]
}'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{}

Modified at 2026-07-09 10:12:26

Text-to-Image (Aspect Ratio + Clarity Controls)

Text Generation