Elevenlabs API Tutorial: Text to Speech in Node.js

steps

1. Retrieve Your API Key

   • Log in to your Elevenlabs account, navigate to the profile/settings page, and copy your API key.

2. Set Up a Node.js Project

   • Initialize a Node.js project if you don’t already have one.
   • Install required dependencies like axios for HTTP requests:
     bashCopy

     npm install axios  

3. Write Code to Make the API Call

   • Use the axios library to call the Elevenlabs API, configure headers, and send the required body parameters:
     javascriptCopy

     const axios = require('axios');  
     const fs = require('fs');  
     
     const API_KEY = 'your-api-key-here';  
     const VOICE_ID = 'your-voice-id-here';  
     const endpoint = `https://api.elevenlabs.io/v1/text-to-speech/${VOICE_ID}`;  
     
     const payload = {  
       text: 'Hello, we are automating text-to-speech with Elevenlabs!',  
       model_id: 'eleven_monolingual_v1',  
       voice_settings: {  
         stability: 0.5,  
         similarity_boost: 0.75  
       }  
     };  
     
     axios.post(endpoint, payload, {  
       headers: {  
         'Authorization': `Bearer ${API_KEY}`,  
         'Content-Type': 'application/json'  
       },  
       responseType: 'arraybuffer'  
     })  
       .then(response => {  
         fs.writeFileSync('output.mp3', response.data);  
         console.log('Audio file saved as output.mp3');  
       })  
       .catch(error => {  
         console.error('Error:', error.response?.data || error.message);  
       });  

4. Execute the Script

   • Run the script in your terminal:

     node filename.js  
     # => Audio file saved as output.mp3  

5. Validate and Listen
   • Open the generated output.mp3 file in any media player to confirm accurate audio.

steps

1. Import API Request into Postman

   • Copy the cURL command provided in the Elevenlabs documentation.
   • Open Postman, go to the "Import" section, and paste the cURL command.

2. Simulate Requests

   • Adjust parameters like text or voice_settings in the Postman body tab.

3. Inspect Responses

   • Ensure the response includes proper audio data.

4. Save/Export Samples for Development

   • Use Postman’s "Save Response" feature to reuse sample outputs during local testing.