# 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.3.0
Security: ShuffllApiKey

## Security:

  - `ShuffllApiKey` (unknown)
    apiKey in header x-api-key

## Response 200:

  - `200` (unknown)
    Successfully retrieved AI voice options.

## 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:

  - `401` (unknown)
    Unauthorized.

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

  - `type` (string)
    Example: object

  - `title` (string)
    Example: Validation failed

  - `message` (string)
    Example: Bad Request

## Response 200 examples:

  - `List of AI voice options and tone styles` (unknown)