Google Vertex AI Integration

​

Create or Select a Google Cloud Project

1. Go to the Google Cloud Console
2. Click on the project dropdown at the top of the page
3. Click New Project or select an existing project
4. If creating new:
   • Enter a Project name
   • Select a Billing account
   • Click Create

​

Enable Vertex AI API

1. In the Google Cloud Console, navigate to APIs & Services > Library
2. Search for Vertex AI API
3. Click on Vertex AI API
4. Click Enable
5. Wait for the API to be enabled (usually takes a few seconds)

​

Create Service Account

1. Navigate to IAM & Admin > Service Accounts
2. Click Create Service Account
3. Configure the service account:
   • Service account name: Enter a name (e.g., emby-vertex-ai)
   • Service account ID: Auto-generated
   • Description: Optional description
4. Click Create and Continue
5. Grant the following role:
   • Vertex AI User (roles/aiplatform.user)
6. Click Continue, then Done

​

Generate API Key (Service Account Key)

1. In the Service Accounts list, find your newly created service account
2. Click on the service account email
3. Go to the Keys tab
4. Click Add Key > Create new key
5. Select JSON as the key type
6. Click Create
7. Important: The JSON key file will be downloaded automatically - keep it secure!

{
  "type": "service_account",
  "project_id": "your-project-id",
  "private_key_id": "...",
  "private_key": "...",
  "client_email": "...",
  ...
}

​

Note Your Project ID

• In the downloaded JSON key file (project_id field)
• In the Google Cloud Console header
• On the project dashboard

​

Navigate to Provider Keys

1. Log into Emby Dashboard
2. Select your organization and project
3. Go to Provider Keys in the sidebar

​

Add Google Vertex AI Provider Key

1. Click Add for Google Vertex AI
2. Enter your Project ID from Google Cloud
3. Upload or paste the contents of your Service Account JSON key file
4. Select your preferred Region (e.g., us-central1, europe-west1, asia-southeast1)
5. Click Add Key

​

Test the Integration

curl -X POST https://dev.emby.ai/v1/chat/completions \
  -H "Authorization: Bearer EMBY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "vertex/gemini-3.0-flash",
    "messages": [
      {
        "role": "user",
        "content": "Hello from Google Vertex AI!"
      }
    ]
  }'