> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List available TTS models and voices

> Returns available TTS models with voices, capabilities, and supported sample rates.
Filter by language using the `language` query parameter.




## OpenAPI

````yaml /Ubuntu/ai-workflows/api-specs/audio-analytics/openapi.yaml get /tts/models
openapi: 3.0.3
info:
  title: Audio Analytics API
  version: 1.0.0
  description: >
    REST API providing AI-powered audio processing: speech recognition (ASR),

    text translation (T2T), and speech synthesis (TTS).


    ## Services


    | Service | Endpoint prefix | Description |

    |---------|----------------|-------------|

    | ASR | `/transcriptions/` | Whisper-based speech-to-text (file or live
    WebSocket streaming) |

    | T2T | `/translations/` | Opus/NLLB text translation (batch supported) |

    | TTS | `/tts/` | MeloTTS speech synthesis; returns raw PCM audio |


    ## Audio formats (ASR input)

    - WAV, 16-bit PCM; 16 kHz mono recommended; max 25 MB


    ## TTS output

    - Supported sample rates: 44100, 22050, 16000 Hz (auto-resampled)


    ## WebSocket streaming sequence


    ```

    App                                           Server
     |===POST /transcriptions/create================>|
     |<==200 {session_id, state: asr_initialized}====|
     |
     |===WS /stream=================================>|
     |<==  {state: connection_established}===========|
     |
     |===WS {transcriptions_session_audio} (loop)===>|
     |<===WS {transcript.event,     speech_start}====|
     |<===WS {transcript.text.delta, ...}============|  (zero or more)
     |<===WS {transcript.event,     speech_end}======|
     |<===WS {transcript.text.done,  ...}============|
     |
     |===POST /transcriptions/close=================>|  (after transcript.text.done)
    ```


    ## Authentication

    None required.
  contact:
    name: Qualcomm Support Forums
    url: https://mysupport.qualcomm.com/supportforums/s/
  license:
    name: BSD-3-Clause-Clear
    url: https://opensource.org/licenses/BSD-3-Clause-Clear
servers:
  - url: http://{device-ip}:{device-port}/audio-analytics/v1/api
    description: Audio Analytics API Server
    variables:
      device-ip:
        description: IP address and port of the host device running the Audio Analytics API
        default: localhost
      device-port:
        default: '8085'
security: []
tags:
  - name: Health
    description: Service health and status endpoints
  - name: Transcriptions
    description: Speech-to-text audio transcription (ASR)
  - name: Translations
    description: Text-to-text translation between languages
  - name: TTS
    description: Text-to-speech synthesis
  - name: WebSocket
    description: Real-time streaming communication
paths:
  /tts/models:
    get:
      tags:
        - TTS
      summary: List available TTS models and voices
      description: >
        Returns available TTS models with voices, capabilities, and supported
        sample rates.

        Filter by language using the `language` query parameter.
      operationId: listTTSModels
      parameters:
        - name: language
          in: query
          required: false
          description: Filter by ISO 639-1 language code (e.g., 'en' for English)
          schema:
            type: string
            example: en
      responses:
        '200':
          description: List of available TTS models
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TTSModel'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    TTSModel:
      type: object
      description: Text-to-speech model information
      properties:
        name:
          type: string
          description: Unique model identifier
          example: melo-tts-en
        display_name:
          type: string
          description: Human-readable model name
          example: MeloTTS English
        version:
          type: string
          description: Model version
          example: 1.0.0
        description:
          type: string
          description: Model description
          example: MeloTTS text-to-speech model with English support
        voices:
          type: array
          items:
            $ref: '#/components/schemas/TTSVoice'
          description: Available voices for this model
        capabilities:
          type: object
          description: Model capabilities
          properties:
            supports_gender:
              type: boolean
              description: Supports gender selection
            supports_style:
              type: boolean
              description: Supports speaking style selection
            supports_sample_rate:
              type: boolean
              description: Supports custom sample rate
            supports_ssml:
              type: boolean
              description: Supports SSML input
            supports_speed_control:
              type: boolean
              description: Supports speaking speed control
            supports_pitch_control:
              type: boolean
              description: Supports pitch control
            supports_volume_control:
              type: boolean
              description: Supports volume control
            supports_resampling:
              type: boolean
              description: Supports automatic resampling
        parameters:
          type: object
          description: Model parameters and constraints
          properties:
            max_text_length:
              type: integer
              description: Maximum text length
            supported_formats:
              type: array
              items:
                type: string
              description: Supported output formats
            sample_rates:
              type: array
              items:
                type: integer
              description: Supported sample rates in Hz
            speed_range:
              type: array
              items:
                type: number
              description: Speaking speed range [min, max]
            pitch_range:
              type: array
              items:
                type: number
              description: Pitch range [min, max]
            volume_range:
              type: array
              items:
                type: number
              description: Volume range [min, max]
      required:
        - name
    ErrorResponse:
      type: object
      description: Standard error response structure
      properties:
        error:
          type: object
          properties:
            message:
              type: string
              description: Human-readable error message
              example: Invalid request, missing 'file' parameter
            type:
              type: string
              description: Error type or category
              example: invalid_request_error
            param:
              type: string
              nullable: true
              description: Parameter related to the error (if applicable)
              example: file
            code:
              type: string
              nullable: true
              description: Error code (if applicable)
              example: null
          required:
            - message
            - type
      required:
        - error
    TTSVoice:
      type: object
      description: Text-to-speech voice information
      properties:
        name:
          type: string
          description: Unique voice identifier
          example: default
        display_name:
          type: string
          description: Human-readable voice name
          example: Default Voice
        language:
          type: string
          description: ISO 639-1 language code
          example: en
        language_name:
          type: string
          description: Language name
          example: English
        gender:
          type: string
          description: Voice gender
          enum:
            - male
            - female
            - neutral
          example: neutral
        style:
          type: string
          description: Speaking style
          example: neutral
        sample_rate:
          type: integer
          description: Native sample rate in Hz
          example: 44100
        description:
          type: string
          description: Voice description
          example: Default voice for English
      required:
        - name
        - language

````