Upscale Image

Upscale images using Imagen on Vertex AI.

Prerequisites

This skill requires Vertex AI credentials (not GEMINI_API_KEY).

Check Current Setup

bash

echo "Project: ${GOOGLE_CLOUD_PROJECT:-NOT SET}"
gcloud auth application-default print-access-token &>/dev/null && echo "Auth: OK" || echo "Auth: NOT CONFIGURED"

First-Time Setup

If credentials are not configured, guide the user through these steps:

•
Get a Google Cloud Project
- •Go to: https://console.cloud.google.com/projectcreate
- •Create a new project or use an existing one
- •Note the Project ID (not the project name)
•
Enable Vertex AI API
- •Go to: https://console.cloud.google.com/apis/library/aiplatform.googleapis.com
- •Click "Enable"
•
Enable Billing
- •Go to: https://console.developers.google.com/billing/enable?project=YOUR_PROJECT_ID
- •Link a billing account
•
Install gcloud CLI (if not installed)
- •Go to: https://cloud.google.com/sdk/docs/install
- •Or on macOS: brew install google-cloud-sdk
•
Authenticate
bash
```
gcloud auth application-default login
```
This opens a browser for Google sign-in.

•

Set Environment Variable

bash

echo 'export GOOGLE_CLOUD_PROJECT=your-project-id' >> ~/.zshenv

Usage

bash

cd ${CLAUDE_PLUGIN_ROOT}/skills/upscale-image && bun run scripts/upscale.ts <input-image> [options]

Options

•--factor <x2|x4> - Upscale factor (default: x2)
•--format <png|jpeg|webp> - Output format
•--quality <n> - JPEG quality (1-100)
•--output <path> - Output path
•--project <id> - Google Cloud project (overrides env var)
•--location <region> - Vertex AI location (default: us-central1)

Examples

bash

cd ${CLAUDE_PLUGIN_ROOT}/skills/upscale-image

# 2x upscale
bun run scripts/upscale.ts photo.jpg

# 4x upscale
bun run scripts/upscale.ts photo.jpg --factor x4

# Upscale and save as PNG
bun run scripts/upscale.ts photo.jpg --factor x4 --format png --output hires.png

# Specify project explicitly
bun run scripts/upscale.ts photo.jpg --project my-gcp-project --factor x4

Model

Uses imagen-3.0-generate-002 via Vertex AI upscaleImage API.

Why Vertex AI?

The Imagen upscaling API is only available through Vertex AI, not the standard Gemini API. This is a Google limitation - the upscaleImage method in the @google/genai SDK only works with Vertex AI backend.