# 🎧 ApexListener: Audio Transcription with AI Response

ApexListener allows you to transcribe audio files and generate AI-powered text responses. Whether the file is hosted online or locally in your project, ApexListener makes it simple to transcribe speech and enhance it with intelligent insights.

First, import the ApexListener function from the apexify.js library:

const { ApexListener } = require('apexify.js'); 

import { ApexListener } from 'apexify.js';

ApexListener processes an audio file (local or via URL) and provides an AI-generated response based on the transcription. You can use it for voice assistants, audio logs, and more!

const options = {
  filepath: 'https://example.com/audio.mp3',  // Can be a URL or a local path
  model: 'gemini',                            // AI model to generate the response
  prompt: 'Summarize this audio',             // (Optional) Custom prompt for the AI to enhance transcription
  apiKey: 'your-api-key'                      // (Optional) API key for the transcription service
};

const { response, transcribe } = await ApexListener(options);
console.log('Transcription:', transcribe);    // The text from the audio file
console.log('AI Response:', response);        // The AI's enhanced response based on transcription

Here are the key parameters for ApexListener:

Provide a URL or a local audio file path, and ApexListener will handle the rest! Local file paths should be relative to your main project directory.

Not only does ApexListener transcribe the audio, but it also passes the transcription to an AI model (like ApexChat) to generate an insightful response. Customize this response by providing your own prompt.

Works with various audio formats like .mp3, .wav, .ogg, and more, ensuring compatibility across different use cases.

1. Provide the Audio: You can either provide a direct URL or a local file path.
2. Transcription: The audio is converted to text.
3. AI Enhancement: Optionally, the transcription is passed to an AI model for further analysis or response generation.
4. Return: The transcribed text and the AI-generated response are returned for use in your application.

const options = {
  filepath: 'audio/meeting-summary.mp3',        // Local path from the main project directory
  model: 'gemini-pro',                          // Using the 'gemini-pro' model for a detailed response
  prompt: 'Provide key takeaways from this meeting', // Custom prompt to guide the AI
  apiKey: ''                                    // Optional API key for enhanced transcription services
};

const { response, transcribe } = await ApexListener(options);
console.log('Transcription:', transcribe);      // Logs the transcription of the audio file
console.log('AI Response:', response);          // Logs the AI-generated key takeaways from the transcription

• Local File Paths: When using local files, make sure the file path is relative to the main project directory. Internally, paths are handled as path.join(process.cwd(), filePath), so structure your project accordingly.

• URL Support: You can also pass a direct URL to an audio file, making it easy to use hosted resources.

• Custom Prompts: If you want to guide the AI's response, use the prompt parameter to steer the AI towards generating summaries, key takeaways, or other insights from the transcription.

• 🎧 Audio Transcription: Transcribe speech from an audio file or URL.
• 💬 AI Integration: Generate AI-driven text responses based on transcriptions.
• 🔗 URL or File Path Support: Flexibly use either online or local audio files.
• ✏️ Customizable Prompts: Guide AI responses with your own custom prompts.

💡 Pro Tip: Combine ApexListener with other ApexAI capabilities like ApexChat and ApexImagine for a fully integrated AI-powered experience!