> ## Documentation Index
> Fetch the complete documentation index at: https://gomodel.enterpilot.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Vertex AI

> Skonfiguruj Gemini w Google Vertex AI w GoModel, w tym uwierzytelnianie przez ADC i konto serwisowe, regiony oraz routing natywny i kompatybilny z OpenAI.

Ta strona dotyczy Gemini hostowanego w **Google Vertex AI**. Informacje o Gemini
przez klucze API Google AI Studio znajdziesz w [przewodniku Google Gemini](https://gomodel.enterpilot.io/docs/pl/providers/gemini.md).

Vertex wymaga projektu GCP, regionu, w którym model jest dostępny, oraz
Application Default Credentials albo klucza JSON konta serwisowego. GoModel
domyślnie kieruje requesty do natywnego endpointu wydawcy Gemini w Vertex;
przełącz się na endpoint kompatybilny z OpenAI, gdy potrzebujesz jego zachowania
kompatybilnościowego.

> [!NOTE]
>
> Uwierzytelnianie Vertex jest przeznaczone dla firm i w przyszłym release’ie
> może stać się płatne lub objęte licencją.

## Konfiguracja

```bash theme={null}
VERTEX_PROJECT=my-gcp-project
VERTEX_LOCATION=us-central1
VERTEX_AUTH_TYPE=gcp_adc       # domyślnie; ADC przez gcloud, GKE Workload Identity lub serwer metadanych
VERTEX_API_MODE=native         # lub openai_compatible
```

Albo w `config.yaml`:

```yaml theme={null}
providers:
  vertex:
    type: vertex
    auth_type: gcp_adc
    vertex_project: my-gcp-project
    vertex_location: us-central1
    api_mode: native
```

### Uwierzytelnianie przez konto serwisowe

```bash theme={null}
VERTEX_AUTH_TYPE=gcp_service_account
VERTEX_SERVICE_ACCOUNT_FILE=/secrets/service-account.json
# lub VERTEX_SERVICE_ACCOUNT_JSON / VERTEX_SERVICE_ACCOUNT_JSON_BASE64
```

### Wiele regionów lub kont

Użyj zmiennych środowiskowych z sufiksem, aby zarejestrować dodatkowych
providerów Vertex:

```bash theme={null}
VERTEX_US_PROJECT=prod-ai
VERTEX_US_LOCATION=us-central1
VERTEX_US_AUTH_TYPE=gcp_adc

VERTEX_EU_PROJECT=prod-ai
VERTEX_EU_LOCATION=europe-west4
VERTEX_EU_AUTH_TYPE=gcp_service_account
VERTEX_EU_SERVICE_ACCOUNT_FILE=/secrets/vertex-eu.json
```

To rejestruje `vertex-us` i `vertex-eu`.

## Base URL-e i tryby

Domyślne adresy bazowe są wyznaczane na podstawie projektu i lokalizacji:

* kompatybilny z OpenAI: `.../projects/{project}/locations/{location}/endpoints/openapi`
* natywny Gemini: `.../projects/{project}/locations/{location}/publishers/google`

Embeddingi w Vertex używają natywnej predykcji Vertex AI niezależnie od
`VERTEX_API_MODE`. W trybie natywnym (domyślnym)
[endpointy obrazów](https://gomodel.enterpilot.io/docs/pl/advanced/images-api.md) są obsługiwane przez endpointy wydawcy
(Imagen przez `predict`, modele obrazowe Gemini przez `generateContent`); w trybie
`openai_compatible` generowanie obrazów jest przekazywane do endpointu
kompatybilnego z OpenAI, a edycja obrazów jest odrzucana. Vertex nie udostępnia
Gemini Files ani operacji batch kompatybilnych z OpenAI.

## Wejście w postaci obrazów

| Tryb | `image_url` w stylu OpenAI |
| - | - |
| `native` (domyślny) | tylko inline’owe URL-e `data:` – zdalne URL-e `https://...` są odrzucane |
| `openai_compatible` | zdalne URL-e w stylu OpenAI są przekazywane do endpointu Vertex kompatybilnego z OpenAI |

## Jeszcze niezintegrowane

* Automatyczne pobieranie zdalnych wartości `image_url` w trybie natywnym.
* Vertex Files i API batch prediction.

## Źródła

* [Vertex AI OpenAI compatibility](https://cloud.google.com/vertex-ai/generative-ai/docs/start/openai)
* [Gemini API in Vertex AI](https://cloud.google.com/vertex-ai/generative-ai/docs/model-reference/inference)
* [Application Default Credentials](https://cloud.google.com/docs/authentication/application-default-credentials)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.