> ## Documentation Index
> Fetch the complete documentation index at: https://docs.easy-peasy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get TTS Configuration

> Retrieve available filter options for text-to-speech voices.

Returns a list of all available languages, accents, and total number of predefined voices.

This endpoint helps you understand what filter values you can use when calling the `/api/get-text-to-speech-voices` endpoint.

**Workflow:**
1. Call without parameters to get all available languages
2. Choose a language
3. Call with `language` parameter to get accents available for that language
4. Use language and accent to filter voices in `/api/get-text-to-speech-voices`

**Note:** This endpoint does not require authentication.



## OpenAPI

````yaml GET /api/get-text-to-speech-config
openapi: 3.0.1
info:
  title: Easy-Peasy.AI API
  description: >-
    OpenAPI Specifications for the Easy-Peasy.AI API.


    All API requests must be authenticated with an API key. Include the
    `x-api-key` API key in the request header with all requests. You can get the
    API key [here](https://easy-peasy.ai/settings/api).
  version: 1.0.4
servers:
  - url: https://easy-peasy.ai
security:
  - apiKeyAuth: []
paths:
  /api/get-text-to-speech-config:
    get:
      summary: Get TTS Configuration
      description: >-
        Retrieve available filter options for text-to-speech voices.


        Returns a list of all available languages, accents, and total number of
        predefined voices.


        This endpoint helps you understand what filter values you can use when
        calling the `/api/get-text-to-speech-voices` endpoint.


        **Workflow:**

        1. Call without parameters to get all available languages

        2. Choose a language

        3. Call with `language` parameter to get accents available for that
        language

        4. Use language and accent to filter voices in
        `/api/get-text-to-speech-voices`


        **Note:** This endpoint does not require authentication.
      operationId: getTTSConfig
      parameters:
        - name: language
          in: query
          required: false
          schema:
            type: string
          description: Filter accents by language (e.g., "English", "Spanish", "French")
          example: English
      responses:
        '200':
          description: Successfully retrieved configuration
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConfigResponse'
              examples:
                all-config:
                  summary: All configuration without filters
                  value:
                    languages:
                      - English
                      - Spanish
                      - French
                      - German
                      - Italian
                      - Portuguese
                      - Polish
                      - Dutch
                      - Hindi
                      - Japanese
                      - Chinese
                    accents:
                      - American
                      - British
                      - Australian
                      - Indian
                      - Irish
                      - Scottish
                      - Spanish
                      - French
                      - German
                    total_voices: 150
                    filtered_by_language: null
                    filtered_voices_count: null
                filtered-config:
                  summary: Configuration filtered by English language
                  value:
                    languages:
                      - English
                      - Spanish
                      - French
                      - German
                      - Italian
                      - Portuguese
                      - Polish
                      - Dutch
                      - Hindi
                      - Japanese
                      - Chinese
                    accents:
                      - American
                      - British
                      - Australian
                      - Indian
                      - Irish
                      - Scottish
                    total_voices: 150
                    filtered_by_language: English
                    filtered_voices_count: 85
        '405':
          description: Method not allowed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Method not allowed
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Server error. Please try again.
      security: []
components:
  schemas:
    ConfigResponse:
      type: object
      required:
        - languages
        - accents
        - total_voices
      properties:
        languages:
          type: array
          items:
            type: string
          description: List of all available languages (sorted alphabetically)
          example:
            - English
            - Spanish
            - French
            - German
        accents:
          type: array
          items:
            type: string
          description: >-
            List of available accents. If `language` parameter was provided,
            only accents for that language are returned.
          example:
            - American
            - British
            - Australian
            - Indian
        total_voices:
          type: integer
          description: Total number of predefined voices available
          example: 150
        filtered_by_language:
          type: string
          nullable: true
          description: The language filter that was applied, or null if no filter was used
          example: English
        filtered_voices_count:
          type: integer
          nullable: true
          description: >-
            Number of voices available for the filtered language, or null if no
            filter was used
          example: 85
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error message
          example: Invalid API key
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        API key for authentication. Get yours at
        https://easy-peasy.ai/settings/api

````