google-veo3-1-mcp-server 1.0.0

package/dist/tools/generate.js

@@ -0,0 +1,210 @@
+/**
+ * Video Generation Tool for Veo 3.1
+ * Supports Text-to-Video, Image-to-Video, and Reference Images
+ */
+import { GEMINI_API_BASE_URL, DEFAULT_POLL_INTERVAL, DEFAULT_MAX_POLL_ATTEMPTS, normalizeModel, normalizeResolution, normalizeAspectRatio, normalizeDuration, calculateCost, isValidResolutionForModel } from '../types/tools.js';
+import { getApiKey, pollVideoResult, downloadAndSaveVideo, extractVideoFromResponse, readImageAsBase64 } from '../utils/video.js';
+import { generateDefaultOutputPath, getDisplayPath } from '../utils/path.js';
+import { debugLog, errorLog } from '../utils/debug.js';
+/**
+ * Generate a video using Veo 3.1 API
+ */
+export async function generateVideo(params) {
+    const apiKey = getApiKey();
+    // Normalize parameters
+    const model = normalizeModel(params.model);
+    const resolution = normalizeResolution(params.resolution);
+    const aspectRatio = normalizeAspectRatio(params.aspect_ratio);
+    const durationSeconds = normalizeDuration(params.duration_seconds);
+    const generateAudio = params.generate_audio ?? true;
+    const sampleCount = typeof params.sample_count === 'string'
+        ? parseInt(params.sample_count, 10)
+        : (params.sample_count ?? 1);
+    // Validate resolution for model
+    if (!isValidResolutionForModel(resolution, model)) {
+        return {
+            success: false,
+            error: `Resolution ${resolution} is not available for model ${model}. Fast model only supports 720p and 1080p.`
+        };
+    }
+    // Validate prompt
+    if (!params.prompt && !params.image) {
+        return {
+            success: false,
+            error: 'Either prompt or image is required for video generation'
+        };
+    }
+    debugLog('Generating video with parameters', {
+        model,
+        resolution,
+        aspectRatio,
+        durationSeconds,
+        generateAudio,
+        hasImage: !!params.image,
+        hasReferenceImages: !!params.reference_images?.length
+    });
+    try {
+        // Build request instance
+        const instance = {};
+        if (params.prompt) {
+            instance.prompt = params.prompt;
+        }
+        // Handle input image (Image-to-Video)
+        if (params.image) {
+            if (params.image.startsWith('gs://')) {
+                instance.image = { gcsUri: params.image };
+            }
+            else {
+                const base64Data = await readImageAsBase64(params.image);
+                instance.image = { bytesBase64Encoded: base64Data };
+            }
+        }
+        // Handle reference images
+        if (params.reference_images && params.reference_images.length > 0) {
+            instance.referenceImages = [];
+            for (const refImage of params.reference_images) {
+                let imageInput;
+                if (refImage.image.startsWith('gs://')) {
+                    imageInput = { gcsUri: refImage.image };
+                }
+                else {
+                    const base64Data = await readImageAsBase64(refImage.image);
+                    imageInput = { bytesBase64Encoded: base64Data };
+                }
+                instance.referenceImages.push({
+                    image: imageInput,
+                    referenceType: refImage.reference_type
+                });
+            }
+        }
+        // Build request parameters
+        // Note: generateAudio is NOT supported in Gemini API preview models
+        // Audio is always generated by default in Veo 3.1 preview
+        const requestParams = {
+            aspectRatio,
+            resolution,
+            durationSeconds,
+            sampleCount
+        };
+        if (params.negative_prompt) {
+            requestParams.negativePrompt = params.negative_prompt;
+        }
+        if (params.person_generation) {
+            requestParams.personGeneration = params.person_generation;
+        }
+        if (params.seed !== undefined) {
+            requestParams.seed = typeof params.seed === 'string'
+                ? parseInt(params.seed, 10)
+                : params.seed;
+        }
+        if (params.compression_quality) {
+            requestParams.compressionQuality = params.compression_quality;
+        }
+        if (params.resize_mode) {
+            requestParams.resizeMode = params.resize_mode;
+        }
+        if (params.storage_uri) {
+            requestParams.storageUri = params.storage_uri;
+        }
+        // Build full request
+        const request = {
+            instances: [instance],
+            parameters: requestParams
+        };
+        debugLog('API Request', request);
+        // Make API call
+        const url = `${GEMINI_API_BASE_URL}/models/${model}:predictLongRunning?key=${apiKey}`;
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify(request)
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            errorLog('API request failed', { status: response.status, error: errorText });
+            // Handle specific error codes
+            if (response.status === 401) {
+                return {
+                    success: false,
+                    error: 'Authentication failed. Please check your GOOGLE_API_KEY.'
+                };
+            }
+            if (response.status === 403) {
+                return {
+                    success: false,
+                    error: 'Access denied. Your API key may not have access to Veo 3.1.'
+                };
+            }
+            if (response.status === 429) {
+                return {
+                    success: false,
+                    error: 'Rate limit exceeded. Please try again later.'
+                };
+            }
+            return {
+                success: false,
+                error: `API request failed: ${response.status} ${response.statusText} - ${errorText}`
+            };
+        }
+        const operationResponse = await response.json();
+        debugLog('Initial operation response', operationResponse);
+        const operationName = operationResponse.name;
+        // Calculate estimated cost
+        const estimatedCost = calculateCost(model, resolution, durationSeconds, generateAudio);
+        // Poll for completion
+        const pollInterval = parseInt(process.env.VIDEO_POLL_INTERVAL || '') || DEFAULT_POLL_INTERVAL;
+        const maxAttempts = parseInt(process.env.VIDEO_MAX_POLL_ATTEMPTS || '') || DEFAULT_MAX_POLL_ATTEMPTS;
+        const finalResponse = await pollVideoResult(operationName, apiKey, pollInterval, maxAttempts);
+        // Check for errors
+        if (finalResponse.error) {
+            return {
+                success: false,
+                operation_name: operationName,
+                error: finalResponse.error.message,
+                failure_reason: `Error code: ${finalResponse.error.code}`
+            };
+        }
+        // Extract video data
+        const videoData = extractVideoFromResponse(finalResponse);
+        if (!videoData) {
+            return {
+                success: false,
+                operation_name: operationName,
+                error: 'No video was generated. The content may have been filtered by safety policies.',
+                estimated_cost: estimatedCost
+            };
+        }
+        // Download and save if output path specified
+        let videoPath;
+        let videoUrl = videoData.url;
+        if (params.output_path || process.env.OUTPUT_DIR) {
+            const outputPath = params.output_path || generateDefaultOutputPath(process.env.OUTPUT_DIR || './output', 'veo3');
+            try {
+                videoPath = await downloadAndSaveVideo(videoData.url, videoData.base64, outputPath);
+                debugLog('Video saved', { path: videoPath });
+            }
+            catch (downloadError) {
+                errorLog('Failed to save video', downloadError);
+                // Don't fail the whole operation if download fails
+            }
+        }
+        return {
+            success: true,
+            operation_name: operationName,
+            video_url: videoUrl,
+            video_path: videoPath ? getDisplayPath(videoPath) : undefined,
+            duration_seconds: durationSeconds,
+            estimated_cost: estimatedCost
+        };
+    }
+    catch (error) {
+        errorLog('Video generation failed', error);
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : String(error)
+        };
+    }
+}
+//# sourceMappingURL=generate.js.map

package/dist/tools/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../src/tools/generate.ts"],"names":[],"mappings":"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"}

package/dist/tools/interpolate.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Frame Interpolation Tool for Veo 3.1
+ * Generates video between first and last frames
+ */
+import { type InterpolateFramesParams, type VideoGenerationResult } from '../types/tools.js';
+/**
+ * Interpolate between first and last frames to generate video
+ *
+ * Creates a smooth video transition between two keyframes
+ */
+export declare function interpolateFrames(params: InterpolateFramesParams): Promise<VideoGenerationResult>;
+//# sourceMappingURL=interpolate.d.ts.map

package/dist/tools/interpolate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolate.d.ts","sourceRoot":"","sources":["../../src/tools/interpolate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EASL,KAAK,uBAAuB,EAG5B,KAAK,qBAAqB,EAG3B,MAAM,mBAAmB,CAAC;AAW3B;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA0LvG"}

package/dist/tools/interpolate.js

@@ -0,0 +1,170 @@
+/**
+ * Frame Interpolation Tool for Veo 3.1
+ * Generates video between first and last frames
+ */
+import { GEMINI_API_BASE_URL, DEFAULT_MODEL, DEFAULT_RESOLUTION, DEFAULT_POLL_INTERVAL, DEFAULT_MAX_POLL_ATTEMPTS, normalizeDuration, calculateCost } from '../types/tools.js';
+import { getApiKey, pollVideoResult, downloadAndSaveVideo, extractVideoFromResponse, readImageAsBase64 } from '../utils/video.js';
+import { generateDefaultOutputPath, getDisplayPath } from '../utils/path.js';
+import { debugLog, errorLog } from '../utils/debug.js';
+/**
+ * Interpolate between first and last frames to generate video
+ *
+ * Creates a smooth video transition between two keyframes
+ */
+export async function interpolateFrames(params) {
+    const apiKey = getApiKey();
+    // Validate required parameters
+    if (!params.first_frame) {
+        return {
+            success: false,
+            error: 'first_frame parameter is required for frame interpolation'
+        };
+    }
+    if (!params.last_frame) {
+        return {
+            success: false,
+            error: 'last_frame parameter is required for frame interpolation'
+        };
+    }
+    const model = DEFAULT_MODEL;
+    const durationSeconds = normalizeDuration(params.duration_seconds);
+    const generateAudio = params.generate_audio ?? true;
+    const resolution = DEFAULT_RESOLUTION;
+    debugLog('Interpolating frames with parameters', {
+        model,
+        durationSeconds,
+        generateAudio,
+        hasPrompt: !!params.prompt
+    });
+    try {
+        // Build request instance
+        const instance = {};
+        if (params.prompt) {
+            instance.prompt = params.prompt;
+        }
+        // Handle first frame (image)
+        if (params.first_frame.startsWith('gs://')) {
+            instance.image = { gcsUri: params.first_frame };
+        }
+        else {
+            const base64Data = await readImageAsBase64(params.first_frame);
+            instance.image = { bytesBase64Encoded: base64Data };
+        }
+        // Handle last frame
+        if (params.last_frame.startsWith('gs://')) {
+            instance.lastFrame = { gcsUri: params.last_frame };
+        }
+        else {
+            const base64Data = await readImageAsBase64(params.last_frame);
+            instance.lastFrame = { bytesBase64Encoded: base64Data };
+        }
+        // Build request parameters
+        // Note: generateAudio is NOT supported in Gemini API preview models
+        const parameters = {
+            durationSeconds
+        };
+        const request = {
+            instances: [instance],
+            parameters
+        };
+        debugLog('API Request', request);
+        // Make API call
+        const url = `${GEMINI_API_BASE_URL}/models/${model}:predictLongRunning?key=${apiKey}`;
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify(request)
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            errorLog('API request failed', { status: response.status, error: errorText });
+            if (response.status === 401) {
+                return {
+                    success: false,
+                    error: 'Authentication failed. Please check your GOOGLE_API_KEY.'
+                };
+            }
+            if (response.status === 403) {
+                return {
+                    success: false,
+                    error: 'Access denied. Your API key may not have access to Veo 3.1.'
+                };
+            }
+            if (response.status === 429) {
+                return {
+                    success: false,
+                    error: 'Rate limit exceeded. Please try again later.'
+                };
+            }
+            if (response.status === 400) {
+                return {
+                    success: false,
+                    error: `Invalid frame images for interpolation. Details: ${errorText}`
+                };
+            }
+            return {
+                success: false,
+                error: `API request failed: ${response.status} ${response.statusText} - ${errorText}`
+            };
+        }
+        const operationResponse = await response.json();
+        debugLog('Initial operation response', operationResponse);
+        const operationName = operationResponse.name;
+        // Calculate estimated cost
+        const estimatedCost = calculateCost(model, resolution, durationSeconds, generateAudio);
+        // Poll for completion
+        const pollInterval = parseInt(process.env.VIDEO_POLL_INTERVAL || '') || DEFAULT_POLL_INTERVAL;
+        const maxAttempts = parseInt(process.env.VIDEO_MAX_POLL_ATTEMPTS || '') || DEFAULT_MAX_POLL_ATTEMPTS;
+        const finalResponse = await pollVideoResult(operationName, apiKey, pollInterval, maxAttempts);
+        // Check for errors
+        if (finalResponse.error) {
+            return {
+                success: false,
+                operation_name: operationName,
+                error: finalResponse.error.message,
+                failure_reason: `Error code: ${finalResponse.error.code}`
+            };
+        }
+        // Extract video data
+        const videoData = extractVideoFromResponse(finalResponse);
+        if (!videoData) {
+            return {
+                success: false,
+                operation_name: operationName,
+                error: 'No video was generated. The content may have been filtered by safety policies.',
+                estimated_cost: estimatedCost
+            };
+        }
+        // Download and save if output path specified
+        let videoPath;
+        let videoUrl = videoData.url;
+        if (params.output_path || process.env.OUTPUT_DIR) {
+            const outputPath = params.output_path || generateDefaultOutputPath(process.env.OUTPUT_DIR || './output', 'veo3_interpolated');
+            try {
+                videoPath = await downloadAndSaveVideo(videoData.url, videoData.base64, outputPath);
+                debugLog('Interpolated video saved', { path: videoPath });
+            }
+            catch (downloadError) {
+                errorLog('Failed to save interpolated video', downloadError);
+            }
+        }
+        return {
+            success: true,
+            operation_name: operationName,
+            video_url: videoUrl,
+            video_path: videoPath ? getDisplayPath(videoPath) : undefined,
+            duration_seconds: durationSeconds,
+            estimated_cost: estimatedCost
+        };
+    }
+    catch (error) {
+        errorLog('Frame interpolation failed', error);
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : String(error)
+        };
+    }
+}
+//# sourceMappingURL=interpolate.js.map

package/dist/tools/interpolate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolate.js","sourceRoot":"","sources":["../../src/tools/interpolate.ts"],"names":[],"mappings":"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"}

package/dist/types/batch.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Batch Processing Type Definitions
+ */
+import type { Model, Resolution, AspectRatio, Duration, ReferenceImage } from './tools.js';
+export type JobType = 'generate' | 'extend' | 'interpolate';
+export interface BaseJob {
+    type?: JobType;
+    output_path?: string;
+}
+export interface GenerateJob extends BaseJob {
+    type?: 'generate';
+    prompt: string;
+    model?: Model;
+    aspect_ratio?: AspectRatio;
+    resolution?: Resolution;
+    duration_seconds?: Duration | number;
+    generate_audio?: boolean;
+    negative_prompt?: string;
+    image?: string;
+    reference_images?: ReferenceImage[];
+}
+export interface ExtendJob extends BaseJob {
+    type: 'extend';
+    video: string;
+    prompt?: string;
+}
+export interface InterpolateJob extends BaseJob {
+    type: 'interpolate';
+    first_frame: string;
+    last_frame: string;
+    prompt?: string;
+    duration_seconds?: Duration | number;
+    generate_audio?: boolean;
+}
+export type BatchJob = GenerateJob | ExtendJob | InterpolateJob;
+export interface RetryPolicy {
+    max_retries: number;
+    retry_delay_ms: number;
+    retry_on_errors: string[];
+}
+export declare const DEFAULT_RETRY_POLICY: RetryPolicy;
+export interface BatchConfig {
+    jobs: BatchJob[];
+    output_dir?: string;
+    default_model?: Model;
+    default_resolution?: Resolution;
+    default_aspect_ratio?: AspectRatio;
+    default_duration_seconds?: Duration | number;
+    default_generate_audio?: boolean;
+    max_concurrent?: number;
+    poll_interval?: number;
+    timeout?: number;
+    retry_policy?: RetryPolicy;
+}
+export interface BatchExecutionOptions {
+    outputDir: string;
+    maxConcurrent: number;
+    pollInterval: number;
+    timeout: number;
+    retryPolicy: RetryPolicy;
+    estimateOnly: boolean;
+    format: 'text' | 'json';
+    noAudio: boolean;
+    allowAnyPath: boolean;
+}
+export declare const DEFAULT_BATCH_OPTIONS: BatchExecutionOptions;
+export interface JobResult {
+    index: number;
+    job: BatchJob;
+    success: boolean;
+    operation_name?: string;
+    video_url?: string;
+    video_path?: string;
+    estimated_cost?: number;
+    error?: string;
+    failure_reason?: string;
+    started_at?: Date;
+    completed_at?: Date;
+    duration_ms?: number;
+    retries?: number;
+}
+export interface BatchResult {
+    total_jobs: number;
+    successful: number;
+    failed: number;
+    cancelled: number;
+    total_estimated_cost: number;
+    jobs: JobResult[];
+    started_at: Date;
+    completed_at: Date;
+    duration_ms: number;
+}
+export interface JobCostEstimate {
+    index: number;
+    job_type: JobType;
+    model: Model;
+    resolution: Resolution;
+    duration_seconds: number;
+    generate_audio: boolean;
+    estimated_cost: number;
+}
+export interface BatchCostEstimate {
+    jobs: JobCostEstimate[];
+    total_estimated_cost: number;
+    total_duration_seconds: number;
+}
+export declare const BATCH_CONSTRAINTS: {
+    minJobs: number;
+    maxJobs: number;
+    minConcurrent: number;
+    maxConcurrent: number;
+    minTimeout: number;
+    maxTimeout: number;
+    minPollInterval: number;
+    maxPollInterval: number;
+    minRetries: number;
+    maxRetries: number;
+    minRetryDelay: number;
+    maxRetryDelay: number;
+};
+//# sourceMappingURL=batch.d.ts.map

package/dist/types/batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../src/types/batch.ts"],"names":[],"mappings":"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"}

package/dist/types/batch.js

@@ -0,0 +1,37 @@
+/**
+ * Batch Processing Type Definitions
+ */
+export const DEFAULT_RETRY_POLICY = {
+    max_retries: 2,
+    retry_delay_ms: 5000,
+    retry_on_errors: ['rate_limit', 'timeout', '429', '503', 'RESOURCE_EXHAUSTED']
+};
+export const DEFAULT_BATCH_OPTIONS = {
+    outputDir: './output',
+    maxConcurrent: 2,
+    pollInterval: 15000,
+    timeout: 1800000, // 30 minutes
+    retryPolicy: DEFAULT_RETRY_POLICY,
+    estimateOnly: false,
+    format: 'text',
+    noAudio: false,
+    allowAnyPath: false
+};
+// =============================================================================
+// Validation Constraints
+// =============================================================================
+export const BATCH_CONSTRAINTS = {
+    minJobs: 1,
+    maxJobs: 100,
+    minConcurrent: 1,
+    maxConcurrent: 5,
+    minTimeout: 60000, // 1 minute
+    maxTimeout: 3600000, // 1 hour
+    minPollInterval: 5000, // 5 seconds
+    maxPollInterval: 60000, // 60 seconds
+    minRetries: 0,
+    maxRetries: 5,
+    minRetryDelay: 100,
+    maxRetryDelay: 60000
+};
+//# sourceMappingURL=batch.js.map

package/dist/types/batch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.js","sourceRoot":"","sources":["../../src/types/batch.ts"],"names":[],"mappings":"AAAA;;GAEG;AAuDH,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,WAAW,EAAE,CAAC;IACd,cAAc,EAAE,IAAI;IACpB,eAAe,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,CAAC;CAC/E,CAAC;AAoCF,MAAM,CAAC,MAAM,qBAAqB,GAA0B;IAC1D,SAAS,EAAE,UAAU;IACrB,aAAa,EAAE,CAAC;IAChB,YAAY,EAAE,KAAK;IACnB,OAAO,EAAE,OAAO,EAAE,aAAa;IAC/B,WAAW,EAAE,oBAAoB;IACjC,YAAY,EAAE,KAAK;IACnB,MAAM,EAAE,MAAM;IACd,OAAO,EAAE,KAAK;IACd,YAAY,EAAE,KAAK;CACpB,CAAC;AA0DF,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,GAAG;IACZ,aAAa,EAAE,CAAC;IAChB,aAAa,EAAE,CAAC;IAChB,UAAU,EAAE,KAAK,EAAO,WAAW;IACnC,UAAU,EAAE,OAAO,EAAK,SAAS;IACjC,eAAe,EAAE,IAAI,EAAG,YAAY;IACpC,eAAe,EAAE,KAAK,EAAE,aAAa;IACrC,UAAU,EAAE,CAAC;IACb,UAAU,EAAE,CAAC;IACb,aAAa,EAAE,GAAG;IAClB,aAAa,EAAE,KAAK;CACrB,CAAC"}