Vertex AI Media Master

Overview

Multimodal media operations on Google Cloud Vertex AI covering video understanding, audio generation, image creation, and marketing campaign automation. This skill orchestrates Gemini 2.5 Pro/Flash, Imagen 4, and Lyria models to process, analyze, and generate rich media assets.

Prerequisites

Google Cloud project with Vertex AI API enabled
google-cloud-aiplatform Python SDK installed (pip install google-cloud-aiplatform[vision,audio])
GOOGLE_CLOUD_PROJECT and GOOGLE_APPLICATION_CREDENTIALS environment variables set
Service account with roles/aiplatform.user permission
Sufficient quota for target models (Gemini 2.5 Pro: 2M tokens/min; Imagen 4: 100 images/min)

Instructions

Initialize the Vertex AI client with the target project and region (us-central1 recommended for model availability).
Select the appropriate model for the task:
- Video analysis: Gemini 2.5 Pro (up to 6 hours at low resolution, 2 hours at default).
- Image generation: Imagen 4 for highest quality stills; Gemini 2.5 Flash Image for interleaved text+image output.
- Audio generation: Lyria for music composition and background tracks.
- Campaign automation: Gemini 2.5 Pro for multi-asset generation from a single prompt.
Prepare input media: upload source files to Cloud Storage (gs:// URIs) or provide local paths for smaller assets.
Construct the generation request with explicit parameters (aspect ratio, duration, number of outputs, style constraints).
Execute the request and capture response objects containing generated media bytes or analysis text.
Post-process outputs: save generated images/audio to the target directory, extract structured insights from video analysis, or compile campaign asset bundles.
Validate results against brand guidelines or schema expectations before delivery.

Output

Generated image files (PNG/JPEG) from Imagen 4 or Gemini Flash Image
Audio files (WAV/MP3) from Lyria model for background music, voiceovers, or sound effects
Video analysis reports: scene breakdowns, key-moment timestamps, transcript text, marketing-insight summaries
Campaign asset packages: hero images, social media graphics, ad copy, email marketing text, and video scripts
Structured JSON metadata for each generated asset (model used, prompt, parameters, cost estimate)

Error Handling

Error	Cause	Solution
`PermissionDenied` on Vertex AI API	Service account lacks `aiplatform.user` role	Grant the required IAM role to the service account
`ResourceExhausted` / quota exceeded	Too many concurrent requests or token limit hit	Implement request batching; switch to Gemini 2.5 Flash for lower-cost operations
`InvalidArgument` on image generation	Prompt violates safety filters or unsupported aspect ratio	Revise the prompt to remove restricted content; use a supported aspect ratio (1:1, 16:9, 9:16)
Video processing timeout	Source video exceeds duration or resolution limits	Use low-resolution mode for videos over 2 hours; split longer videos into segments
Audio generation returns empty	Prompt too vague or duration parameter missing	Specify genre, tempo, mood, and an explicit duration in seconds
`NotFound` on model ID	Incorrect model name or model not available in region	Verify the model ID against current Vertex AI documentation; try `us-central1`

Examples

Example 1: Analyze a competitor video ad

Input: A 60-second competitor video uploaded to gs://bucket/competitor-ad.mp4.
Action: Send to Gemini 2.5 Pro with the prompt "Extract messaging themes, calls to action, visual style, and production techniques."
Output: Structured analysis with timestamps for key scenes, identified CTAs, and a competitive positioning summary.

Example 2: Generate campaign assets from a product brief

Input: Text brief describing a new product launch with target audience and brand guidelines.
Action: Use Imagen 4 to generate 4 hero image variations, Lyria for a 30-second background track, and Gemini 2.5 Pro for ad copy in 3 languages.
Output: Directory containing hero images, audio file, and a campaign-copy document organized by language.

Example 3: Repurpose a long-form video into short-form clips

Input: A 10-minute product demo video.
Action: Gemini 2.5 Pro identifies the three most engaging 15-second segments with scene-boundary timestamps.
Output: Timestamp list with suggested captions for TikTok/Reels, plus a storyboard summary for each clip.

Resources

Detailed model capabilities and code patterns: ${CLAUDE_SKILL_DIR}/references/core-capabilities.md
Vertex AI Multimodal overview: https://cloud.google.com/vertex-ai/generative-ai/docs/multimodal/overview
Imagen documentation: https://cloud.google.com/vertex-ai/generative-ai/docs/image/overview
Video understanding guide: https://cloud.google.com/vertex-ai/generative-ai/docs/multimodal/video-understanding
GenAI for Marketing reference repo: https://github.com/GoogleCloudPlatform/genai-for-marketing

vertex-ai-media-master