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

# Translate text between languages

> Translates text from a source language to a target language.

## Features
- Batch translation (multiple texts in one request)
- Automatic language detection (if source not specified)
- Custom parameters for fine-tuning

## Supported Languages
Query `/translations/models` to see available language pairs.

## Example Request
```json
{
  "text": ["Hello world", "How are you?"],
  "model": "opus-en-es",
  "source_language": "en",
  "target_language": "es"
}
```

## Example Response
```json
{
  "translations": [
    {
      "translated_text": "Hola mundo",
      "target_language": "es",
      "source_language": "en"
    },
    {
      "translated_text": "¿Cómo estás?",
      "target_language": "es",
      "source_language": "en"
    }
  ]
}
```




## OpenAPI

````yaml /Ubuntu/ai-workflows/api-specs/audio-analytics/openapi.yaml post /translations/translate
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:
  /translations/translate:
    post:
      tags:
        - Translations
      summary: Translate text between languages
      description: |
        Translates text from a source language to a target language.

        ## Features
        - Batch translation (multiple texts in one request)
        - Automatic language detection (if source not specified)
        - Custom parameters for fine-tuning

        ## Supported Languages
        Query `/translations/models` to see available language pairs.

        ## Example Request
        ```json
        {
          "text": ["Hello world", "How are you?"],
          "model": "opus-en-es",
          "source_language": "en",
          "target_language": "es"
        }
        ```

        ## Example Response
        ```json
        {
          "translations": [
            {
              "translated_text": "Hola mundo",
              "target_language": "es",
              "source_language": "en"
            },
            {
              "translated_text": "¿Cómo estás?",
              "target_language": "es",
              "source_language": "en"
            }
          ]
        }
        ```
      operationId: translateText
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TranslationRequest'
            example:
              text:
                - Hello world
                - How are you?
              model: opus-en-es
              source_language: en
              target_language: es
      responses:
        '200':
          description: Translation successful
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TranslationResponse'
        '400':
          description: Bad request - invalid input
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    TranslationRequest:
      type: object
      description: Translation request
      properties:
        text:
          type: array
          items:
            type: string
          description: Array of text strings to translate
          example:
            - Hello world
            - How are you?
        model:
          type: string
          description: Translation model ID
          example: opus-en-es
        source_language:
          type: string
          description: Source language code (ISO 639-1). If omitted, may be auto-detected.
          example: en
        target_language:
          type: string
          description: Target language code (ISO 639-1)
          example: es
        parameters:
          description: Optional parameters for translation
          oneOf:
            - type: object
              additionalProperties: {}
            - type: array
              items:
                $ref: '#/components/schemas/KeyValueParam'
          example:
            - key: formality
              value: informal
      required:
        - text
        - model
        - target_language
    TranslationResponse:
      type: object
      description: Translation result
      properties:
        translations:
          type: array
          items:
            type: object
            properties:
              translated_text:
                type: string
                description: Translated text
                example: Hola mundo
              target_language:
                type: string
                description: Target language code
                example: es
              source_language:
                type: string
                description: Source language code (detected or specified)
                example: en
            required:
              - translated_text
          description: Array of translation results (same order as input)
      required:
        - translations
    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
    KeyValueParam:
      type: object
      description: Key-value pair for additional parameters
      properties:
        key:
          type: string
          description: Parameter name
          example: sampling_rate
        value:
          type: string
          description: Parameter value
          example: '16000'
      required:
        - key
        - value

````