Gemini 2.5 Flash Image examples

Generate an image with gemini-2.5-flash-image

curl --request POST \
  --url https://api.yingtu.ai/v1beta/models/gemini-2.5-flash-image:generateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "A single yellow ceramic banana on a matte white background, soft studio lighting, no text."
        }
      ]
    }
  ]
}
'

import requests

url = "https://api.yingtu.ai/v1beta/models/gemini-2.5-flash-image:generateContent"

payload = { "contents": [
        {
            "role": "user",
            "parts": [{ "text": "A single yellow ceramic banana on a matte white background, soft studio lighting, no text." }]
        }
    ] }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    contents: [
      {
        role: 'user',
        parts: [
          {
            text: 'A single yellow ceramic banana on a matte white background, soft studio lighting, no text.'
          }
        ]
      }
    ]
  })
};

fetch('https://api.yingtu.ai/v1beta/models/gemini-2.5-flash-image:generateContent', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "BASE64_IMAGE_DATA"
            }
          }
        ]
      },
      "finishReason": "STOP",
      "index": 0
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 37,
    "candidatesTokenCount": 1846,
    "totalTokenCount": 1883,
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 37
      }
    ],
    "candidatesTokensDetails": [
      {
        "modality": "IMAGE",
        "tokenCount": 1680
      }
    ]
  },
  "modelVersion": "gemini-2.5-flash-image",
  "responseId": "response_example"
}

{
  "error": {
    "message": "<string>",
    "type": "invalid_request_error",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "invalid_request_error",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "invalid_request_error",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "invalid_request_error",
    "code": "<string>"
  }
}

POST

v1beta

models

gemini-2.5-flash-image:generateContent

Generate an image with gemini-2.5-flash-image

curl --request POST \
  --url https://api.yingtu.ai/v1beta/models/gemini-2.5-flash-image:generateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "A single yellow ceramic banana on a matte white background, soft studio lighting, no text."
        }
      ]
    }
  ]
}
'

import requests

url = "https://api.yingtu.ai/v1beta/models/gemini-2.5-flash-image:generateContent"

payload = { "contents": [
        {
            "role": "user",
            "parts": [{ "text": "A single yellow ceramic banana on a matte white background, soft studio lighting, no text." }]
        }
    ] }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    contents: [
      {
        role: 'user',
        parts: [
          {
            text: 'A single yellow ceramic banana on a matte white background, soft studio lighting, no text.'
          }
        ]
      }
    ]
  })
};

fetch('https://api.yingtu.ai/v1beta/models/gemini-2.5-flash-image:generateContent', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "BASE64_IMAGE_DATA"
            }
          }
        ]
      },
      "finishReason": "STOP",
      "index": 0
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 37,
    "candidatesTokenCount": 1846,
    "totalTokenCount": 1883,
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 37
      }
    ],
    "candidatesTokensDetails": [
      {
        "modality": "IMAGE",
        "tokenCount": 1680
      }
    ]
  },
  "modelVersion": "gemini-2.5-flash-image",
  "responseId": "response_example"
}

{
  "error": {
    "message": "<string>",
    "type": "invalid_request_error",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "invalid_request_error",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "invalid_request_error",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "invalid_request_error",
    "code": "<string>"
  }
}

Generate synchronously

curl 'https://api.yingtu.ai/v1beta/models/gemini-2.5-flash-image:generateContent' \
  -H 'Authorization: Bearer YOUR_YINGTU_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{"text": "A glazed ceramic bird on a quiet white shelf"}]
    }],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {"aspectRatio": "1:1"}
    }
  }'

import os
import requests

response = requests.post(
    "https://api.yingtu.ai/v1beta/models/"
    "gemini-2.5-flash-image:generateContent",
    headers={"Authorization": f"Bearer {os.environ['YINGTU_API_KEY']}"},
    json={
        "contents": [{"role": "user", "parts": [
            {"text": "A glazed ceramic bird on a quiet white shelf"}
        ]}],
        "generationConfig": {
            "responseModalities": ["TEXT", "IMAGE"],
            "imageConfig": {"aspectRatio": "1:1"},
        },
    },
    timeout=120,
)
response.raise_for_status()
result = response.json()

A successful live response contained one text part followed by a PNG image part:

{
  "candidates": [{
    "content": {
      "role": "model",
      "parts": [
        {"text": "Here is the generated image:"},
        {"inlineData": {"mimeType": "image/png", "data": "BASE64_IMAGE_DATA"}}
      ]
    },
    "finishReason": "STOP",
    "index": 0
  }],
  "usageMetadata": {"promptTokenCount": 37, "totalTokenCount": 1338},
  "modelVersion": "gemini-2.5-flash-image",
  "responseId": "response_example"
}

Submit asynchronously

Use the same body with :asyncGenerateContent. HTTP 202 returns a task ID; retrieve it from /v1/tasks/{task_id}. The verified task moved through in_progress and completed with a 1024 × 1024 PNG.

curl 'https://api.yingtu.ai/v1beta/models/gemini-2.5-flash-image:asyncGenerateContent' \
  -H 'Authorization: Bearer YOUR_YINGTU_API_KEY' \
  -H 'Content-Type: application/json' \
  -d @request.json

Decode every image part

import base64

for candidate in result["candidates"]:
    for part in candidate["content"]["parts"]:
        if "inlineData" not in part:
            continue
        mime_type = part["inlineData"]["mimeType"]
        image_bytes = base64.b64decode(part["inlineData"]["data"])

The image may not be the first part, even in a successful response.

Test this model online

This page includes the real OpenAPI Try it form for the fixed gemini-2.5-flash-image path. Enter a development key, review the request body, and send the synchronous call without leaving this example.

The request is billable. Mintlify shows the entered key in its generated cURL; do not share authenticated screenshots.

Authorizations

Authorization

string

header

required

YingTu API key.

Body

application/json

contents

Message · object[]

required

Prompt and optional source image.

Minimum array length: 1

Show child attributes

generationConfig

Output settings · object

Show child attributes

Response

Complete Gemini response

candidates

object[]

required

Show child attributes

usageMetadata

object

Show child attributes

modelVersion

string

The model version that produced the response.

Example:

"gemini-2.5-flash-image"

responseId

string

Provider response identifier.

Example:

"response_example"

createTime

string<date-time>

Creation time when supplied by the selected model channel.

​Generate synchronously

​Submit asynchronously

​Decode every image part

​Test this model online

Authorizations

Body

Response

Generate synchronously

Submit asynchronously

Decode every image part

Test this model online