Skip to main content
Version: Next

Google Vertex AI Models

from: google:<model-id> selects a Vertex AI language model. A model ID, GCP project, location, and Google Cloud credentials are required. Google AI Studio API keys are not supported.

ParameterDescriptionDefault
google_projectRequired. GCP project ID containing lowercase letters, digits, and hyphens.-
google_locationRequired. GCP region (for example us-central1) or global.-
google_service_account_pathPath to a GCP service account JSON key file.-
google_service_account_keyService account JSON. Supports secret replacement.-
google_application_default_credentialsApplication Default Credentials from the file specified by GOOGLE_APPLICATION_CREDENTIALS.false

Authentication requires exactly one of google_service_account_path, google_service_account_key, or google_application_default_credentials: true.

Example spicepod.yml configuration:

models:
  - from: google:gemini-2.5-pro
    name: gemini
    params:
      google_project: my-gcp-project
      google_location: us-central1
      google_service_account_path: /etc/spice/gcp-service-account.json

google_service_account_key: ${ secrets:GCP_SERVICE_ACCOUNT_KEY } selects a secret instead of a file.

Vertex AI Generative AI models lists model availability by project and region.

See Large Language Models for additional configuration options: