# Get AI voice options

Retrieve all available AI voice-over options and tone styles.

Returns two arrays:
- aiVoiceOptions — the list of available voices. Use the id value as aiVoiceSettings.voiceId when creating a project.
- aiVoiceTones — tone styles that can be layered on top of a voice (e.g., friendly, professional, dramatic).

Voices are provided by either OpenAI or ElevenLabs depending on the voiceType field.

Endpoint: GET /auth/config/ai_voice_options
Version: 1.2.0
Security: ShuffllApiKey

## Response 200 fields (application/json):

  - `aiVoiceOptions` (array)
    List of available voice-over options

  - `aiVoiceOptions.id` (string)
    Voice identifier — use as aiVoiceSettings.voiceId when creating a project
    Example: "alloy"

  - `aiVoiceOptions.name` (string)
    Internal voice name
    Example: "alloy"

  - `aiVoiceOptions.title` (string)
    Display title of the voice
    Example: "Alloy"

  - `aiVoiceOptions.subtitle` (string)
    Short description of the voice character
    Example: "Neutral and balanced"

  - `aiVoiceOptions.voiceType` (string)
    Voice provider
    Enum: "open-ai", "eleven-labs"

  - `aiVoiceOptions.tones` (array)
    Tone IDs supported by this voice
    Example: ["friendly","professional"]

  - `aiVoiceTones` (array)
    List of tone styles that can be applied to a voice

  - `aiVoiceTones.id` (string)
    Tone identifier
    Example: "friendly"

  - `aiVoiceTones.title` (string)
    Display name of the tone
    Example: "Friendly"

  - `aiVoiceTones.instructions` (string)
    Style instructions passed to the voice model
    Example: "Speak in a warm, approachable manner"

## Response 401 fields (application/problem+json):

  - `type` (string)
    Example: "object"

  - `title` (string)
    Example: "Validation failed"

  - `message` (string)
    Example: "Bad Request"