Audio

const response = await layer.tts({
  gateId: 'your-gate-id',
  data: {
    input: 'Hello! Welcome to Layer AI text-to-speech.'
  }
});

console.log('Audio URL:', response.audio.url);
console.log('Duration:', response.audio.duration, 'seconds');
console.log('Cost:', response.cost);

const response = await layer.tts({
  gateId: 'your-gate-id',
  data: {
    input: 'The weather today is sunny and warm.',
    voice: 'alloy'  // Options: alloy, echo, fable, onyx, nova, shimmer
  }
});

const response = await layer.tts({
  gateId: 'your-gate-id',
  data: {
    input: 'Sample text',
    responseFormat: 'mp3'  // mp3, opus, aac, flac, wav, pcm
  }
});

const response = await layer.tts({
  gateId: 'your-gate-id',
  data: {
    input: 'This will be spoken at different speeds.',
    speed: 1.25  // 0.25 to 4.0
  }
});

interface AudioResponse {
  id: string;                    // Request ID
  model: string;                 // Model used
  audio: AudioOutput;            // Audio data
  cost: number;                  // Request cost in USD
  latency: number;               // Response time in ms
}

interface AudioOutput {
  url?: string;                  // Hosted audio URL
  base64?: string;               // Base64-encoded audio
  format?: string;               // Audio format
  duration?: number;             // Length in seconds
}

// Good ✅ - Natural speech patterns
{
  input: 'Hello, and welcome to our podcast. Today we\'re discussing AI.'
}

// Less natural - Missing punctuation
{
  input: 'hello and welcome to our podcast today were discussing AI'
}

{
  input: '<speak>Hello! <break time="500ms"/> This is a pause.</speak>'
}

// Good ✅ - MP3 for web playback
{
  input: 'Website announcement',
  responseFormat: 'mp3'
}

// Good ✅ - FLAC for podcast production
{
  input: 'Podcast episode narration',
  responseFormat: 'flac'
}

try {
  const response = await layer.tts({
    gateId: 'your-gate-id',
    data: {
      input: 'Sample text'
    }
  });

  return response.audio.url;
} catch (error) {
  console.error('TTS generation failed:', error);
  return null;
}

const response = await layer.tts({
  gateId: 'your-gate-id',
  data: {
    input: longText
  }
});

console.log(`Duration: ${response.audio.duration}s`);
console.log(`Cost: $${response.cost.toFixed(6)}`);
console.log(`Characters: ${longText.length}`);

const response = await layer.tts({
  gateId: 'your-gate-id',
  metadata: { type: 'podcast-intro' },
  data: {
    input: 'Welcome to Tech Talks, the podcast where we explore the latest in technology and innovation.',
    voice: 'fable',
    responseFormat: 'mp3',
    speed: 1.0
  }
});

const response = await layer.tts({
  gateId: 'your-gate-id',
  data: {
    input: 'Introducing our new flagship product, designed to revolutionize your workflow!',
    voice: 'nova',
    speed: 1.1
  }
});

const response = await layer.tts({
  gateId: 'your-gate-id',
  data: {
    input: 'In this lesson, we will learn about photosynthesis, the process by which plants convert sunlight into energy.',
    voice: 'echo',
    speed: 0.9,  // Slower for learning
    responseFormat: 'mp3'
  }
});

const chapter = `
  Chapter One: The Beginning.

  It was a dark and stormy night. The wind howled through the trees,
  and rain pounded against the windows of the old mansion.
`;

const response = await layer.tts({
  gateId: 'your-gate-id',
  data: {
    input: chapter,
    voice: 'fable',
    responseFormat: 'flac',  // High quality for production
    speed: 1.0
  }
});

const response = await layer.tts({
  gateId: 'your-gate-id',
  data: {
    input: 'Your package will arrive tomorrow between 2 and 4 PM.',
    voice: 'alloy',
    responseFormat: 'opus',  // Small file for quick delivery
    speed: 1.0
  }
});

const response = await layer.tts({
  gateId: 'your-gate-id',
  data: {
    input: 'Bonjour! Comment allez-vous?',
    voice: 'shimmer'
  }
});

const scripts = [
  'Welcome to the tour.',
  'This is the main lobby.',
  'Here is the conference room.',
  'Thank you for visiting!'
];

const audioFiles = await Promise.all(
  scripts.map(text =>
    layer.tts({
      gateId: 'your-gate-id',
      data: {
        input: text,
        voice: 'echo'
      }
    })
  )
);

audioFiles.forEach((response, i) => {
  console.log(`Audio ${i + 1}:`, response.audio.url);
});

const response = await layer.tts({
  gateId: 'your-gate-id',
  data: {
    input: 'Hello world',
    responseFormat: 'mp3'
  }
});

// Download to local file
const audioData = await fetch(response.audio.url);
const buffer = await audioData.arrayBuffer();
await fs.writeFile('output.mp3', Buffer.from(buffer));

const response = await layer.tts({
  gateId: 'your-gate-id',
  data: {
    input: 'Sample text',
    responseFormat: 'mp3'
  }
});

// Use base64 in HTML
const audioHTML = `
  <audio controls>
    <source src="${response.audio.base64}" type="audio/mpeg">
  </audio>
`;

const response = await layer.tts({
  gateId: 'your-gate-id',
  model: 'tts-1-hd',  // High-quality model
  data: {
    input: 'Premium audio content'
  }
});

const response = await layer.tts({
  gateId: 'your-gate-id',
  metadata: {
    userId: 'user-123',
    feature: 'voiceover',
    language: 'en-US'
  },
  data: {
    input: 'Sample narration'
  }
});

const lesson = await layer.tts({
  gateId: 'your-gate-id',
  data: {
    input: courseText,
    voice: 'echo',
    speed: 0.9,
    responseFormat: 'mp3'
  }
});

const greeting = await layer.tts({
  gateId: 'your-gate-id',
  data: {
    input: 'Thank you for calling. Press 1 for sales, press 2 for support.',
    voice: 'alloy',
    responseFormat: 'wav'
  }
});

const narration = await layer.tts({
  gateId: 'your-gate-id',
  data: {
    input: videoScript,
    voice: 'fable',
    responseFormat: 'flac'
  }
});

const audioVersion = await layer.tts({
  gateId: 'your-gate-id',
  data: {
    input: articleText,
    voice: 'echo',
    speed: 1.0,
    responseFormat: 'mp3'
  }
});