Voice Settings

import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const client = new ElevenLabsClient({ apiKey: "your-api-key" });
// Access this API via: client.voices.settings

/**
 * @param requestOptions - Optional request configuration
 * @returns Default voice settings
 */
client.voices.settings.getDefault(
  requestOptions?: RequestOptions
): HttpResponsePromise<VoiceSettings>;

interface VoiceSettings {
  /** Stability (0.0 to 1.0) - Higher = more consistent, lower = more variable */
  stability: number;
  /** Similarity boost (0.0 to 1.0) - Higher = closer to original, lower = more creative */
  similarity_boost: number;
  /** Style exaggeration (0.0 to 1.0, only for v2 models) */
  style?: number;
  /** Enable speaker boost for better clarity */
  use_speaker_boost?: boolean;
  /** Speed (0.25 to 4.0) - Speaking rate multiplier */
  speed?: number;
}

/**
 * @param voice_id - Voice ID
 * @param requestOptions - Optional request configuration
 * @returns Voice settings
 * @throws UnprocessableEntityError if request fails
 */
client.voices.settings.get(
  voice_id: string,
  requestOptions?: RequestOptions
): HttpResponsePromise<VoiceSettings>;

/**
 * @param voice_id - Voice ID
 * @param request - Updated voice settings
 * @param requestOptions - Optional request configuration
 * @returns Update confirmation
 * @throws UnprocessableEntityError if request fails
 */
client.voices.settings.update(
  voice_id: string,
  request: VoiceSettings,
  requestOptions?: RequestOptions
): HttpResponsePromise<EditVoiceSettingsResponseModel>;

interface EditVoiceSettingsResponseModel {
  /** Status of the update ('ok' if successful) */
  status: string;
}

import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const client = new ElevenLabsClient({ apiKey: "your-api-key" });

// Get default voice settings for your account
const defaultSettings = await client.voices.settings.getDefault();
console.log("Default stability:", defaultSettings.stability);
console.log("Default similarity:", defaultSettings.similarity_boost);

// Get settings for a specific voice
const voiceSettings = await client.voices.settings.get("voice-id");

// Update voice settings
await client.voices.settings.update("voice-id", {
  stability: 0.75,
  similarity_boost: 0.85,
  style: 0.5,
  use_speaker_boost: true,
  speed: 1.0,
});