Voices

// List voices (returns VoiceListResponse)
const result = await client.voices.list();

for (const voice of result.voices) {
  console.log(`${voice.id}: ${voice.name}`);
  console.log(`  Category: ${voice.category}`);
  console.log(`  Languages: ${voice.supportedLanguages.join(', ')}`);
}
console.log(`Showing ${result.voices.length} of ${result.total}`);

// Paginate
const page2 = await client.voices.list({ limit: 10, offset: 10 });
console.log(`Page 2: ${page2.voices.length} voices (total: ${page2.total})`);

// Only voices that speak German
const german = await client.voices.list({ language: 'de' });
console.log(`${german.total} German voices`);

const voice = await client.voices.get(1071);
console.log(`Voice: ${voice.name}`);
console.log(`Category: ${voice.category}`);

// Browser: use File objects from an <input type="file">
const fileInput = document.getElementById('audio-upload') as HTMLInputElement;
const files = Array.from(fileInput.files!);

const voice = await client.voices.create({
  name: 'My Custom Voice',
  sex: 'female',
  description: 'A warm, conversational voice',
  category: 'conversational',
  referenceFiles: files,
});
console.log(`Created voice: ${voice.id}`);

// Node.js: use File so the multipart upload retains its filename extension
import { readFileSync } from 'fs';
import { File } from 'node:buffer';

const buf = readFileSync('reference.wav');
const file = new File([new Uint8Array(buf)], 'reference.wav', { type: 'audio/wav' });

const voice = await client.voices.create({
  name: 'My Custom Voice',
  sex: 'female',
  referenceFiles: [file],
});

const voice = await client.voices.update(1071, {
  name: 'Updated Name',
  description: 'New description',
});

await client.voices.delete(1071);

// Add a new reference; audioFile is a File or Blob, built as in "Create a Voice"
const ref = await client.voices.addReference(1071, audioFile, 'Optional transcript.');

// Delete a reference
await client.voices.deleteReference(1071, 456);

const voice = await client.voices.publish(1071);
console.log(`Pending verification: ${voice.pendingVerification}`);