Gemini 3.1 Flash Lite Image examples

Generate an image with gemini-3.1-flash-lite-image

curl --request POST \
  --url https://api.yingtu.ai/v1beta/models/gemini-3.1-flash-lite-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-3.1-flash-lite-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-3.1-flash-lite-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-3.1-flash-lite-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-3.1-flash-lite-image:generateContent

Generate an image with gemini-3.1-flash-lite-image

curl --request POST \
  --url https://api.yingtu.ai/v1beta/models/gemini-3.1-flash-lite-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-3.1-flash-lite-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-3.1-flash-lite-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-3.1-flash-lite-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>"
  }
}

Create a 1K image

curl 'https://api.yingtu.ai/v1beta/models/gemini-3.1-flash-lite-image:generateContent' \
  -H 'Authorization: Bearer YOUR_YINGTU_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{"text": "A friendly app icon made from folded yellow paper"}]
    }],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {"aspectRatio": "1:1", "imageSize": "1K"}
    }
  }'

import os
import requests

body = {
    "contents": [{"role": "user", "parts": [
        {"text": "A friendly app icon made from folded yellow paper"}
    ]}],
    "generationConfig": {
        "responseModalities": ["TEXT", "IMAGE"],
        "imageConfig": {"aspectRatio": "1:1", "imageSize": "1K"},
    },
}
response = requests.post(
    "https://api.yingtu.ai/v1beta/models/"
    "gemini-3.1-flash-lite-image:generateContent",
    headers={"Authorization": f"Bearer {os.environ['YINGTU_API_KEY']}"},
    json=body,
    timeout=120,
)
response.raise_for_status()
result = response.json()

The verified output was a 1024 × 1024 PNG in the first image part:

{
  "candidates": [{
    "content": {
      "role": "model",
      "parts": [{
        "inlineData": {"mimeType": "image/png", "data": "BASE64_IMAGE_DATA"}
      }]
    },
    "finishReason": "STOP"
  }],
  "usageMetadata": {"promptTokenCount": 42, "totalTokenCount": 1162},
  "modelVersion": "gemini-3.1-flash-lite-image",
  "responseId": "response_example"
}

Queue the same job

Change the method suffix to :asyncGenerateContent. In live verification the submit returned queued, and the task completed after four polls with the same 1K PNG response shape under result.

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

When reading either mode, iterate over every part and decode only entries with inlineData.

Test this model online

The OpenAPI panel on this page is fixed to gemini-3.1-flash-lite-image:generateContent and prefills the valid 1K body. Enter a development key and use Try it without navigating elsewhere.

Try it 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-3.1-flash-lite-image"

responseId

string

Provider response identifier.

Example:

"response_example"

createTime

string<date-time>

Creation time when supplied by the selected model channel.

​Create a 1K image

​Queue the same job

​Test this model online

Authorizations

Body

Response

Create a 1K image

Queue the same job

Test this model online