Client Initialization

/**
 * Main client class for Google Gemini API and Vertex AI
 * @param options - Configuration options
 */
class GoogleGenAI {
  constructor(options?: GoogleGenAIOptions);

  readonly models: Models;
  readonly chats: Chats;
  readonly live: Live;
  readonly batches: Batches;
  readonly caches: Caches;
  readonly files: Files;
  readonly operations: Operations;
  readonly authTokens: Tokens;
  readonly tunings: Tunings;
  readonly fileSearchStores: FileSearchStores;
  readonly vertexai: boolean;
}

interface GoogleGenAIOptions {
  /** Use Vertex AI API (true) or Gemini API (false, default) */
  vertexai?: boolean;
  /** Google Cloud project ID (Vertex AI only, Node.js only) */
  project?: string;
  /** Google Cloud location (Vertex AI only, Node.js only) */
  location?: string;
  /** API Key (required for Gemini API, especially in browser) */
  apiKey?: string;
  /** API version to use */
  apiVersion?: string;
  /** Authentication options from google-auth-library (Node.js only) */
  googleAuthOptions?: GoogleAuthOptions;
  /** HTTP request customization */
  httpOptions?: HttpOptions;
}

import { GoogleGenAI } from '@google/genai';

// Gemini Developer API (with API key)
const client = new GoogleGenAI({
  apiKey: 'YOUR_API_KEY'
});

// Vertex AI (Node.js with Google Cloud authentication)
const vertexClient = new GoogleGenAI({
  vertexai: true,
  project: 'my-project-id',
  location: 'us-central1'
});

// With custom HTTP options
const customClient = new GoogleGenAI({
  apiKey: 'YOUR_API_KEY',
  httpOptions: {
    timeout: 30000,
    headers: {
      'Custom-Header': 'value'
    }
  }
});

/** Content generation, image/video generation, embeddings, model management */
readonly models: Models;

/** Multi-turn conversation management */
readonly chats: Chats;

/** Real-time bidirectional communication (experimental) */
readonly live: Live;

/** Batch processing operations */
readonly batches: Batches;

/** Context caching for efficiency */
readonly caches: Caches;

/** File upload and management (Gemini API only) */
readonly files: Files;

/** Long-running operation management */
readonly operations: Operations;

/** Authentication token management (experimental) */
readonly authTokens: Tokens;

/** Model tuning operations (experimental) */
readonly tunings: Tunings;

/** File search store operations */
readonly fileSearchStores: FileSearchStores;

/** Whether using Vertex AI */
readonly vertexai: boolean;

interface HttpOptions {
  /** Custom base URL */
  baseUrl?: string;
  /** API version */
  apiVersion?: string;
  /** Custom headers */
  headers?: Record<string, string>;
  /** Request timeout in milliseconds */
  timeout?: number;
  /** Extra body parameters */
  extraBody?: Record<string, unknown>;
}

interface GoogleAuthOptions {
  // Options from google-auth-library package
  // See: https://github.com/googleapis/google-auth-library-nodejs
}

import { GoogleGenAI } from '@google/genai/web';

const client = new GoogleGenAI({
  apiKey: 'YOUR_API_KEY'
});

import { GoogleGenAI } from '@google/genai/node';

// With API key
const client = new GoogleGenAI({
  apiKey: 'YOUR_API_KEY'
});

// With Vertex AI and Application Default Credentials
const vertexClient = new GoogleGenAI({
  vertexai: true,
  project: 'my-project-id',
  location: 'us-central1'
});