Google Image Generation

Overview

GoogleImageGenService provides high-quality image generation capabilities using Google’s Gemini image models. It supports generating multiple images from text prompts with various customization options and advanced prompt understanding for photorealistic and artistic image creation.

Google Image Generation API Reference

Pipecat’s API methods for Google image generation

Example Implementation

Browse examples using Google image generation

Gemini Image Generation Documentation

Official Google Gemini image generation documentation

Google Cloud Console

Access Gemini models and manage API keys

Installation

To use Google image generation services, install the required dependencies:

uv add "pipecat-ai[google]"

Prerequisites

Google Cloud Setup

Before using Google image generation services, you need:

Google Cloud Account: Set up at Google Cloud Console
API Key: Generate a Google API key with Gemini API access
Project Configuration: Enable Gemini API for your project
Model Access: Ensure access to Gemini image models

Required Environment Variables

GOOGLE_API_KEY: Your Google API key for authentication

Configuration

str

required

Google AI API key for authentication.

InputParams

default:"None"

deprecated

Deprecated since 0.0.105, removed in 2.0.0. Use settings=GoogleImageGenService.Settings(...) instead.

Any

default:"None"

HTTP options for the Google AI client.

GoogleImageGenService.Settings

default:"None"

Runtime-configurable generation settings. See Settings below.

Settings

Runtime-configurable settings passed via the settings constructor argument using GoogleImageGenService.Settings(...). See Service Settings for details.

Parameter	Type	Default	Description
`model`	`str`	`"gemini-3.1-flash-image"`	Gemini image model identifier. (Inherited from base settings.)
`number_of_images`	`int`	`1`	Number of images to generate per prompt (1-8). Each image is a separate request.
`aspect_ratio`	`str \| None`	`"1:1"`	Aspect ratio of generated images, such as `"1:1"` or `"16:9"`. `None` leaves the model’s own default in place.
`image_size`	`str \| None`	`None`	Resolution of generated images, one of `"1K"`, `"2K"` or `"4K"`. `None` leaves the model’s own default in place. Supported sizes vary by model.
`negative_prompt`	`str \| None`	`None`	Deprecated since 1.13.0, removed in 2.0.0. No replacement. Gemini image models do not accept a negative prompt, so the value is ignored.

Usage

Basic Setup

import os

from pipecat.services.google.image import GoogleImageGenService

image_gen = GoogleImageGenService(
    api_key=os.getenv("GOOGLE_API_KEY"),
)

With Settings

image_gen = GoogleImageGenService(
    api_key=os.getenv("GOOGLE_API_KEY"),
    settings=GoogleImageGenService.Settings(
        model="gemini-3.1-flash-image",
        number_of_images=2,
        aspect_ratio="16:9",
    ),
)

Notes

RGB output: Generated images are converted to RGB format for compatibility with output transports that render RGB video by default.
Sequential generation: When number_of_images is greater than 1, each image is generated in a separate request, processed one after another.
No HTTP session needed: Google returns image data directly in the API response, so no separate HTTP session is required for downloading.
Metrics support: Google image generation supports TTFB metrics tracking.

Get Started

Pipecat Server

Client SDKs

Pipecat Flows

Pipecat Cloud

CLI

Pipecat Context Hub

Google Image Generation

Overview

Google Image Generation API Reference

Example Implementation

Gemini Image Generation Documentation

Google Cloud Console

Installation

Prerequisites

Google Cloud Setup

Required Environment Variables

Configuration

Settings

Usage

Basic Setup

With Settings

Notes

​Overview

Google Image Generation API Reference

Example Implementation

Gemini Image Generation Documentation

Google Cloud Console

​Installation

​Prerequisites

​Google Cloud Setup

​Required Environment Variables

​Configuration

​Settings

​Usage

​Basic Setup

​With Settings

​Notes

Overview

Installation

Prerequisites

Google Cloud Setup

Required Environment Variables

Configuration

Settings

Usage

Basic Setup

With Settings

Notes