@blinkdotnew/sdk 0.14.13 → 0.17.0

package/README.md

@@ -353,12 +353,27 @@ const { object: todoList } = await blink.ai.generateObject({
 // })
 // Error: "schema must be a JSON Schema of 'type: \"object\"', got 'type: \"array\"'"
 
-// Image generation
+// Generate and modify images with AI
+
+// Basic image generation - returns public URLs directly
 const { data } = await blink.ai.generateImage({
-  prompt: 'A serene landscape',
+  prompt: 'A serene landscape with mountains and a lake at sunset',
   size: '1024x1024',
-  quality: 'hd'
+  quality: 'hd',
+  n: 2
+})
+console.log('Image URL:', data[0].url)
+
+// Image editing - transform existing images with prompts
+const { data: headshots } = await blink.ai.modifyImage({
+  images: ['https://storage.example.com/user-photo.jpg'], // ... up to 16 images maximum!
+  prompt: 'Generate professional business headshot with studio lighting for this person.',
+  quality: 'hd',
+  n: 4
 })
+// Options: size ('1024x1024', '1536x1024'), quality ('standard'|'hd'), 
+// background ('auto'|'transparent'|'opaque'), n (1-10 images)
+
 
 // Speech synthesis
 const { url } = await blink.ai.generateSpeech({
@@ -690,12 +705,20 @@ try {
 // Upload files (returns public URL directly)
 const { publicUrl } = await blink.storage.upload(
   file,
-  'path/to/file.jpg',
+  'path/to/file',
   {
     upsert: true,
     onProgress: (percent) => console.log(`${percent}%`)
   }
 )
+// If file is PNG, final path will be: path/to/file.png
+
+// 💡 Pro tip: Use the actual filename (file.name) in your path to avoid confusion
+const { publicUrl } = await blink.storage.upload(
+  file,
+  `uploads/${file.name}`, // Uses actual filename with correct extension
+  { upsert: true }
+)
 
 // Remove files
 await blink.storage.remove('file1.jpg', 'file2.jpg')

package/dist/index.d.mts

@@ -119,8 +119,17 @@ interface FileObject {
 }
 interface BlinkStorage {
     upload(file: File | Blob | Buffer, path: string, options?: StorageUploadOptions): Promise<StorageUploadResponse>;
+    download(path: string, options?: {
+        filename?: string;
+    }): Promise<StorageDownloadResponse>;
     remove(...paths: string[]): Promise<void>;
 }
+interface StorageDownloadResponse {
+    downloadUrl: string;
+    filename: string;
+    contentType?: string;
+    size?: number;
+}
 interface TokenUsage {
     promptTokens: number;
     completionTokens: number;
@@ -211,10 +220,15 @@ interface ObjectGenerationResponse {
 interface ImageGenerationRequest {
     model?: string;
     prompt: string;
+    images?: string[];
     size?: string;
     quality?: 'standard' | 'hd';
+    background?: 'auto' | 'transparent' | 'opaque';
     n?: number;
     response_format?: 'url' | 'b64_json';
+    output_format?: 'png' | 'jpeg' | 'webp';
+    output_compression?: number;
+    moderation?: 'auto' | 'low';
     signal?: AbortSignal;
 }
 interface ImageGenerationResponse {
@@ -273,6 +287,15 @@ interface BlinkAI {
     generateObject(options: ObjectGenerationRequest): Promise<ObjectGenerationResponse>;
     streamObject(options: ObjectGenerationRequest, onPartial: (partial: any) => void): Promise<ObjectGenerationResponse>;
     generateImage(options: ImageGenerationRequest): Promise<ImageGenerationResponse>;
+    modifyImage(options: {
+        images: string[];
+        prompt: string;
+        size?: string;
+        quality?: "standard" | "hd";
+        n?: number;
+        background?: "auto" | "transparent" | "opaque";
+        signal?: AbortSignal;
+    }): Promise<ImageGenerationResponse>;
     generateSpeech(options: SpeechGenerationRequest): Promise<SpeechGenerationResponse>;
     transcribeAudio(options: TranscriptionRequest): Promise<TranscriptionResponse>;
 }
@@ -660,10 +683,15 @@ declare class HttpClient {
     } | undefined, onPartial: (partial: any) => void): Promise<any>;
     aiImage(prompt: string, options?: {
         model?: string;
+        images?: string[];
         size?: string;
         quality?: 'standard' | 'hd';
+        background?: 'auto' | 'transparent' | 'opaque';
         n?: number;
         response_format?: 'url' | 'b64_json';
+        output_format?: 'png' | 'jpeg' | 'webp';
+        output_compression?: number;
+        moderation?: 'auto' | 'low';
         signal?: AbortSignal;
     }): Promise<BlinkResponse<any>>;
     aiSpeech(text: string, options?: {
@@ -1022,6 +1050,7 @@ interface BlinkAnalytics {
     setUserId(userId: string | null): void;
     setUserEmail(email: string | null): void;
     clearAttribution(): void;
+    destroy(): void;
 }
 declare class BlinkAnalyticsImpl implements BlinkAnalytics {
     private httpClient;
@@ -1043,6 +1072,10 @@ declare class BlinkAnalyticsImpl implements BlinkAnalytics {
      * Disable analytics tracking
      */
     disable(): void;
+    /**
+     * Cleanup analytics instance (remove from global tracking)
+     */
+    destroy(): void;
     /**
      * Enable analytics tracking
      */
@@ -1113,23 +1146,74 @@ declare class BlinkStorageImpl implements BlinkStorage {
      * Upload a file to project storage
      *
      * @param file - File, Blob, or Buffer to upload
-     * @param path - Destination path within project storage
+     * @param path - Destination path within project storage (extension will be auto-corrected to match file type)
      * @param options - Upload options including upsert and progress callback
      * @returns Promise resolving to upload response with public URL
      *
      * @example
      * ```ts
+     * // Extension automatically corrected to match actual file type
      * const { publicUrl } = await blink.storage.upload(
-     *   fileInput.files[0],
-     *   `avatars/${user.id}.png`,
-     *   {
-     *     upsert: true,
-     *     onProgress: pct => console.log(`${pct}%`)
-     *   }
+     *   pngFile,
+     *   `avatars/${user.id}`, // No extension needed!
+     *   { upsert: true }
+     * );
+     * // If file is PNG, final path will be: avatars/user123.png
+     *
+     * // Or with extension (will be corrected if wrong)
+     * const { publicUrl } = await blink.storage.upload(
+     *   pngFile,
+     *   `avatars/${user.id}.jpg`, // Wrong extension
+     *   { upsert: true }
      * );
+     * // Final path will be: avatars/user123.png (auto-corrected!)
      * ```
      */
     upload(file: File | Blob | Buffer, path: string, options?: StorageUploadOptions): Promise<StorageUploadResponse>;
+    /**
+     * Detect file type from actual file content and correct path extension
+     * This ensures the path extension always matches the actual file type
+     */
+    private detectFileTypeAndCorrectPath;
+    /**
+     * Get the first few bytes of a file to analyze its signature
+     */
+    private getFileSignature;
+    /**
+     * Detect file type from file signature (magic numbers)
+     * This is the most reliable way to detect actual file type
+     */
+    private detectFileTypeFromSignature;
+    /**
+     * Get file extension from MIME type as fallback
+     */
+    private getExtensionFromMimeType;
+    /**
+     * Get a download URL for a file that triggers browser download
+     *
+     * @param path - Path to the file in project storage
+     * @param options - Download options including custom filename
+     * @returns Promise resolving to download response with download URL
+     *
+     * @example
+     * ```ts
+     * // Download with original filename
+     * const { downloadUrl, filename } = await blink.storage.download('images/photo.jpg');
+     * window.open(downloadUrl, '_blank');
+     *
+     * // Download with custom filename
+     * const { downloadUrl } = await blink.storage.download(
+     *   'images/photo.jpg',
+     *   { filename: 'my-photo.jpg' }
+     * );
+     *
+     * // Create download link in React
+     * <a href={downloadUrl} download={filename}>Download Image</a>
+     * ```
+     */
+    download(path: string, options?: {
+        filename?: string;
+    }): Promise<StorageDownloadResponse>;
     /**
      * Remove one or more files from project storage
      *
@@ -1362,15 +1446,15 @@ declare class BlinkAIImpl implements BlinkAI {
      */
     streamObject(options: ObjectGenerationRequest, onPartial: (partial: any) => void): Promise<ObjectGenerationResponse>;
     /**
-     * Generates images from text descriptions using AI image models.
+     * Generates images from text descriptions using AI.
      *
      * @param options - Object containing:
-     *   - `prompt`: Text description of the image to generate (required)
-     *   - `size`: Image dimensions (e.g., "1024x1024", "512x512") - varies by model
-     *   - `quality`: Image quality ("standard" or "hd")
+     *   - `prompt`: Text description of the desired image (required)
+     *   - `size`: Image dimensions (default: "1024x1024")
+     *   - `quality`: Image quality ("standard" or "hd", default: "standard")
      *   - `n`: Number of images to generate (default: 1)
-     *   - `response_format`: Output format ("url" or "b64_json")
-     *   - Plus optional model, signal parameters
+     *   - `background`: Background handling ("auto", "transparent", "opaque", default: "auto")
+     *   - Plus optional signal parameter
      *
      * @example
      * ```ts
@@ -1383,31 +1467,103 @@ declare class BlinkAIImpl implements BlinkAI {
      * // High-quality image with specific size
      * const { data } = await blink.ai.generateImage({
      *   prompt: "A futuristic city skyline with flying cars",
-     *   size: "1792x1024",
+     *   size: "1536x1024",
      *   quality: "hd",
-     *   model: "dall-e-3"
+     *   background: "transparent"
      * });
      *
      * // Multiple images
      * const { data } = await blink.ai.generateImage({
      *   prompt: "A cute robot mascot for a tech company",
      *   n: 3,
-     *   size: "1024x1024"
+     *   size: "1024x1024",
+     *   quality: "hd"
      * });
      * data.forEach((img, i) => console.log(`Image ${i+1}:`, img.url));
+     * ```
      *
-     * // Base64 format for direct embedding
-     * const { data } = await blink.ai.generateImage({
-     *   prompt: "A minimalist logo design",
-     *   response_format: "b64_json"
+     * @returns Promise<ImageGenerationResponse> - Object containing:
+     *   - `data`: Array of generated images with URLs
+     *   - `created`: Timestamp of generation
+     *   - `usage`: Token usage information
+     */
+    generateImage(options: {
+        prompt: string;
+        size?: string;
+        quality?: "standard" | "hd";
+        n?: number;
+        background?: "auto" | "transparent" | "opaque";
+        signal?: AbortSignal;
+    }): Promise<ImageGenerationResponse>;
+    /**
+     * Modifies existing images using AI with text prompts for image-to-image editing.
+     *
+     * @param options - Object containing:
+     *   - `images`: Array of public image URLs to modify (required, up to 16 images)
+     *   - `prompt`: Text description of desired modifications (required)
+     *   - `size`: Output image dimensions (default: "auto")
+     *   - `quality`: Image quality ("standard" or "hd", default: "standard")
+     *   - `n`: Number of output images to generate (default: 1)
+     *   - `background`: Background handling ("auto", "transparent", "opaque", default: "auto")
+     *   - Plus optional signal parameter
+     *
+     * @example
+     * ```ts
+     * // Professional headshots from casual photos
+     * const { data } = await blink.ai.modifyImage({
+     *   images: [
+     *     "https://storage.example.com/user-photo-1.jpg",
+     *     "https://storage.example.com/user-photo-2.jpg"
+     *   ],
+     *   prompt: "Transform into professional business headshots with studio lighting",
+     *   quality: "hd",
+     *   n: 4
+     * });
+     * data.forEach((img, i) => console.log(`Headshot ${i+1}:`, img.url));
+     *
+     * // Artistic style transformation
+     * const { data } = await blink.ai.modifyImage({
+     *   images: ["https://storage.example.com/portrait.jpg"],
+     *   prompt: "Transform into oil painting style with dramatic lighting",
+     *   quality: "hd",
+     *   size: "1024x1024"
+     * });
+     *
+     * // Background replacement
+     * const { data } = await blink.ai.modifyImage({
+     *   images: ["https://storage.example.com/product.jpg"],
+     *   prompt: "Remove background and place on clean white studio background",
+     *   background: "transparent",
+     *   n: 2
+     * });
+     *
+     * // Batch processing multiple photos
+     * const userPhotos = [
+     *   "https://storage.example.com/photo1.jpg",
+     *   "https://storage.example.com/photo2.jpg",
+     *   "https://storage.example.com/photo3.jpg"
+     * ];
+     * const { data } = await blink.ai.modifyImage({
+     *   images: userPhotos,
+     *   prompt: "Convert to black and white vintage style photographs",
+     *   quality: "hd"
      * });
-     * console.log("Base64 data:", data[0].b64_json);
      * ```
      *
      * @returns Promise<ImageGenerationResponse> - Object containing:
-     *   - `data`: Array of generated images with url or b64_json
+     *   - `data`: Array of modified images with URLs
+     *   - `created`: Timestamp of generation
+     *   - `usage`: Token usage information
      */
-    generateImage(options: ImageGenerationRequest): Promise<ImageGenerationResponse>;
+    modifyImage(options: {
+        images: string[];
+        prompt: string;
+        size?: string;
+        quality?: "standard" | "hd";
+        n?: number;
+        background?: "auto" | "transparent" | "opaque";
+        signal?: AbortSignal;
+    }): Promise<ImageGenerationResponse>;
     /**
      * Converts text to speech using AI voice synthesis models.
      *

package/dist/index.d.ts

@@ -119,8 +119,17 @@ interface FileObject {
 }
 interface BlinkStorage {
     upload(file: File | Blob | Buffer, path: string, options?: StorageUploadOptions): Promise<StorageUploadResponse>;
+    download(path: string, options?: {
+        filename?: string;
+    }): Promise<StorageDownloadResponse>;
     remove(...paths: string[]): Promise<void>;
 }
+interface StorageDownloadResponse {
+    downloadUrl: string;
+    filename: string;
+    contentType?: string;
+    size?: number;
+}
 interface TokenUsage {
     promptTokens: number;
     completionTokens: number;
@@ -211,10 +220,15 @@ interface ObjectGenerationResponse {
 interface ImageGenerationRequest {
     model?: string;
     prompt: string;
+    images?: string[];
     size?: string;
     quality?: 'standard' | 'hd';
+    background?: 'auto' | 'transparent' | 'opaque';
     n?: number;
     response_format?: 'url' | 'b64_json';
+    output_format?: 'png' | 'jpeg' | 'webp';
+    output_compression?: number;
+    moderation?: 'auto' | 'low';
     signal?: AbortSignal;
 }
 interface ImageGenerationResponse {
@@ -273,6 +287,15 @@ interface BlinkAI {
     generateObject(options: ObjectGenerationRequest): Promise<ObjectGenerationResponse>;
     streamObject(options: ObjectGenerationRequest, onPartial: (partial: any) => void): Promise<ObjectGenerationResponse>;
     generateImage(options: ImageGenerationRequest): Promise<ImageGenerationResponse>;
+    modifyImage(options: {
+        images: string[];
+        prompt: string;
+        size?: string;
+        quality?: "standard" | "hd";
+        n?: number;
+        background?: "auto" | "transparent" | "opaque";
+        signal?: AbortSignal;
+    }): Promise<ImageGenerationResponse>;
     generateSpeech(options: SpeechGenerationRequest): Promise<SpeechGenerationResponse>;
     transcribeAudio(options: TranscriptionRequest): Promise<TranscriptionResponse>;
 }
@@ -660,10 +683,15 @@ declare class HttpClient {
     } | undefined, onPartial: (partial: any) => void): Promise<any>;
     aiImage(prompt: string, options?: {
         model?: string;
+        images?: string[];
         size?: string;
         quality?: 'standard' | 'hd';
+        background?: 'auto' | 'transparent' | 'opaque';
         n?: number;
         response_format?: 'url' | 'b64_json';
+        output_format?: 'png' | 'jpeg' | 'webp';
+        output_compression?: number;
+        moderation?: 'auto' | 'low';
         signal?: AbortSignal;
     }): Promise<BlinkResponse<any>>;
     aiSpeech(text: string, options?: {
@@ -1022,6 +1050,7 @@ interface BlinkAnalytics {
     setUserId(userId: string | null): void;
     setUserEmail(email: string | null): void;
     clearAttribution(): void;
+    destroy(): void;
 }
 declare class BlinkAnalyticsImpl implements BlinkAnalytics {
     private httpClient;
@@ -1043,6 +1072,10 @@ declare class BlinkAnalyticsImpl implements BlinkAnalytics {
      * Disable analytics tracking
      */
     disable(): void;
+    /**
+     * Cleanup analytics instance (remove from global tracking)
+     */
+    destroy(): void;
     /**
      * Enable analytics tracking
      */
@@ -1113,23 +1146,74 @@ declare class BlinkStorageImpl implements BlinkStorage {
      * Upload a file to project storage
      *
      * @param file - File, Blob, or Buffer to upload
-     * @param path - Destination path within project storage
+     * @param path - Destination path within project storage (extension will be auto-corrected to match file type)
      * @param options - Upload options including upsert and progress callback
      * @returns Promise resolving to upload response with public URL
      *
      * @example
      * ```ts
+     * // Extension automatically corrected to match actual file type
      * const { publicUrl } = await blink.storage.upload(
-     *   fileInput.files[0],
-     *   `avatars/${user.id}.png`,
-     *   {
-     *     upsert: true,
-     *     onProgress: pct => console.log(`${pct}%`)
-     *   }
+     *   pngFile,
+     *   `avatars/${user.id}`, // No extension needed!
+     *   { upsert: true }
+     * );
+     * // If file is PNG, final path will be: avatars/user123.png
+     *
+     * // Or with extension (will be corrected if wrong)
+     * const { publicUrl } = await blink.storage.upload(
+     *   pngFile,
+     *   `avatars/${user.id}.jpg`, // Wrong extension
+     *   { upsert: true }
      * );
+     * // Final path will be: avatars/user123.png (auto-corrected!)
      * ```
      */
     upload(file: File | Blob | Buffer, path: string, options?: StorageUploadOptions): Promise<StorageUploadResponse>;
+    /**
+     * Detect file type from actual file content and correct path extension
+     * This ensures the path extension always matches the actual file type
+     */
+    private detectFileTypeAndCorrectPath;
+    /**
+     * Get the first few bytes of a file to analyze its signature
+     */
+    private getFileSignature;
+    /**
+     * Detect file type from file signature (magic numbers)
+     * This is the most reliable way to detect actual file type
+     */
+    private detectFileTypeFromSignature;
+    /**
+     * Get file extension from MIME type as fallback
+     */
+    private getExtensionFromMimeType;
+    /**
+     * Get a download URL for a file that triggers browser download
+     *
+     * @param path - Path to the file in project storage
+     * @param options - Download options including custom filename
+     * @returns Promise resolving to download response with download URL
+     *
+     * @example
+     * ```ts
+     * // Download with original filename
+     * const { downloadUrl, filename } = await blink.storage.download('images/photo.jpg');
+     * window.open(downloadUrl, '_blank');
+     *
+     * // Download with custom filename
+     * const { downloadUrl } = await blink.storage.download(
+     *   'images/photo.jpg',
+     *   { filename: 'my-photo.jpg' }
+     * );
+     *
+     * // Create download link in React
+     * <a href={downloadUrl} download={filename}>Download Image</a>
+     * ```
+     */
+    download(path: string, options?: {
+        filename?: string;
+    }): Promise<StorageDownloadResponse>;
     /**
      * Remove one or more files from project storage
      *
@@ -1362,15 +1446,15 @@ declare class BlinkAIImpl implements BlinkAI {
      */
     streamObject(options: ObjectGenerationRequest, onPartial: (partial: any) => void): Promise<ObjectGenerationResponse>;
     /**
-     * Generates images from text descriptions using AI image models.
+     * Generates images from text descriptions using AI.
      *
      * @param options - Object containing:
-     *   - `prompt`: Text description of the image to generate (required)
-     *   - `size`: Image dimensions (e.g., "1024x1024", "512x512") - varies by model
-     *   - `quality`: Image quality ("standard" or "hd")
+     *   - `prompt`: Text description of the desired image (required)
+     *   - `size`: Image dimensions (default: "1024x1024")
+     *   - `quality`: Image quality ("standard" or "hd", default: "standard")
      *   - `n`: Number of images to generate (default: 1)
-     *   - `response_format`: Output format ("url" or "b64_json")
-     *   - Plus optional model, signal parameters
+     *   - `background`: Background handling ("auto", "transparent", "opaque", default: "auto")
+     *   - Plus optional signal parameter
      *
      * @example
      * ```ts
@@ -1383,31 +1467,103 @@ declare class BlinkAIImpl implements BlinkAI {
      * // High-quality image with specific size
      * const { data } = await blink.ai.generateImage({
      *   prompt: "A futuristic city skyline with flying cars",
-     *   size: "1792x1024",
+     *   size: "1536x1024",
      *   quality: "hd",
-     *   model: "dall-e-3"
+     *   background: "transparent"
      * });
      *
      * // Multiple images
      * const { data } = await blink.ai.generateImage({
      *   prompt: "A cute robot mascot for a tech company",
      *   n: 3,
-     *   size: "1024x1024"
+     *   size: "1024x1024",
+     *   quality: "hd"
      * });
      * data.forEach((img, i) => console.log(`Image ${i+1}:`, img.url));
+     * ```
      *
-     * // Base64 format for direct embedding
-     * const { data } = await blink.ai.generateImage({
-     *   prompt: "A minimalist logo design",
-     *   response_format: "b64_json"
+     * @returns Promise<ImageGenerationResponse> - Object containing:
+     *   - `data`: Array of generated images with URLs
+     *   - `created`: Timestamp of generation
+     *   - `usage`: Token usage information
+     */
+    generateImage(options: {
+        prompt: string;
+        size?: string;
+        quality?: "standard" | "hd";
+        n?: number;
+        background?: "auto" | "transparent" | "opaque";
+        signal?: AbortSignal;
+    }): Promise<ImageGenerationResponse>;
+    /**
+     * Modifies existing images using AI with text prompts for image-to-image editing.
+     *
+     * @param options - Object containing:
+     *   - `images`: Array of public image URLs to modify (required, up to 16 images)
+     *   - `prompt`: Text description of desired modifications (required)
+     *   - `size`: Output image dimensions (default: "auto")
+     *   - `quality`: Image quality ("standard" or "hd", default: "standard")
+     *   - `n`: Number of output images to generate (default: 1)
+     *   - `background`: Background handling ("auto", "transparent", "opaque", default: "auto")
+     *   - Plus optional signal parameter
+     *
+     * @example
+     * ```ts
+     * // Professional headshots from casual photos
+     * const { data } = await blink.ai.modifyImage({
+     *   images: [
+     *     "https://storage.example.com/user-photo-1.jpg",
+     *     "https://storage.example.com/user-photo-2.jpg"
+     *   ],
+     *   prompt: "Transform into professional business headshots with studio lighting",
+     *   quality: "hd",
+     *   n: 4
+     * });
+     * data.forEach((img, i) => console.log(`Headshot ${i+1}:`, img.url));
+     *
+     * // Artistic style transformation
+     * const { data } = await blink.ai.modifyImage({
+     *   images: ["https://storage.example.com/portrait.jpg"],
+     *   prompt: "Transform into oil painting style with dramatic lighting",
+     *   quality: "hd",
+     *   size: "1024x1024"
+     * });
+     *
+     * // Background replacement
+     * const { data } = await blink.ai.modifyImage({
+     *   images: ["https://storage.example.com/product.jpg"],
+     *   prompt: "Remove background and place on clean white studio background",
+     *   background: "transparent",
+     *   n: 2
+     * });
+     *
+     * // Batch processing multiple photos
+     * const userPhotos = [
+     *   "https://storage.example.com/photo1.jpg",
+     *   "https://storage.example.com/photo2.jpg",
+     *   "https://storage.example.com/photo3.jpg"
+     * ];
+     * const { data } = await blink.ai.modifyImage({
+     *   images: userPhotos,
+     *   prompt: "Convert to black and white vintage style photographs",
+     *   quality: "hd"
      * });
-     * console.log("Base64 data:", data[0].b64_json);
      * ```
      *
      * @returns Promise<ImageGenerationResponse> - Object containing:
-     *   - `data`: Array of generated images with url or b64_json
+     *   - `data`: Array of modified images with URLs
+     *   - `created`: Timestamp of generation
+     *   - `usage`: Token usage information
      */
-    generateImage(options: ImageGenerationRequest): Promise<ImageGenerationResponse>;
+    modifyImage(options: {
+        images: string[];
+        prompt: string;
+        size?: string;
+        quality?: "standard" | "hd";
+        n?: number;
+        background?: "auto" | "transparent" | "opaque";
+        signal?: AbortSignal;
+    }): Promise<ImageGenerationResponse>;
     /**
      * Converts text to speech using AI voice synthesis models.
      *