Google Vertex AI

​

Overview

​

Installation

uv add "pipecat-ai[google]"

​

Prerequisites

​

Google Cloud Setup

1. Google Cloud Account: Sign up at Google Cloud Console
2. Project Setup: Create a project and enable the Vertex AI API
3. Service Account: Create a service account with Vertex AI permissions
4. Authentication: Set up credentials via service account key or Application Default Credentials

​

Required Environment Variables

• GOOGLE_APPLICATION_CREDENTIALS: Path to your service account key file (recommended)
• Or use Application Default Credentials for cloud deployments

​

Configuration

​

Usage

​

Basic Setup

import os
from pipecat.services.google.vertex.llm import GoogleVertexLLMService

llm = GoogleVertexLLMService(
    credentials_path=os.getenv("GOOGLE_APPLICATION_CREDENTIALS"),
    project_id="my-gcp-project",
    location="us-east4",
    model="gemini-2.5-flash",
)

​

With Credentials JSON String

from pipecat.services.google.vertex.llm import GoogleVertexLLMService

llm = GoogleVertexLLMService(
    credentials=os.getenv("GOOGLE_CREDENTIALS_JSON"),
    project_id="my-gcp-project",
    location="us-central1",
    settings=GoogleVertexLLMService.Settings(
        model="gemini-2.5-flash",
        temperature=0.7,
        top_p=0.9,
    ),
)

​

With Application Default Credentials

from pipecat.services.google.vertex.llm import GoogleVertexLLMService

# Uses ADC when neither credentials nor credentials_path is provided
llm = GoogleVertexLLMService(
    project_id="my-gcp-project",
    location="us-east4",
    model="gemini-2.5-flash",
)

​

Notes

• This service does not accept an api_key parameter. Use credentials, credentials_path, or Application Default Credentials instead.
• GoogleVertexLLMService extends GoogleLLMService and uses the Google AI Python SDK with Vertex AI authentication.
• Authentication supports three methods: direct JSON credentials string, path to a service account key file, or Application Default Credentials (ADC).
• The project_id parameter is required. If location is not provided, it defaults to "us-east4".