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

# Translation

> Translate text with Server-Sent Events (SSE) streaming response.

## Endpoint

`POST /translation/stream`

## Authentication

Use either API key or JWT token.

```http theme={null}
Authorization: Bearer YOUR_MUNSIT_API_KEY
```

## Request body

| Field             | Type   | Required | Description                                    |
| ----------------- | ------ | -------- | ---------------------------------------------- |
| `text`            | string | Yes      | Input text to translate                        |
| `target_language` | string | Yes      | Full target language name, such as `Arabic`    |
| `source_language` | string | No       | Source language or `string` for auto-detection |
| `model_name`      | string | No       | Translation model, default `qwen/qwen3-32b`    |
| `prompt_name`     | string | No       | Prompt template, default `quick-translate`     |
| `prompt_version`  | string | No       | Prompt version, default `1.2.0`                |

## Response stream events

* `session_info`: request/session metadata
* `start`: translation start with detected source language
* `chunk`: partial translation content
* `complete`: final translation output and metadata

## Notes

* Response is streamed as Server-Sent Events (SSE)
* Keep the connection open until a `complete` event is received


## OpenAPI

````yaml POST /translation/stream
openapi: 3.1.0
info:
  title: Munsit API
  description: >-
    Munsit - First True Arabic Voice AI that speaks Dialects From Abu Dhabi to
    Rabat with Voice Cloning & On-prem support
  version: 1.0.0
servers:
  - url: https://api.munsit.com/api/v1
    description: Global production server
  - url: https://ae.api.faseeh.ai/api/v1
    description: UAE regional server
security:
  - apiKeyAuth: []
paths:
  /translation/stream:
    post:
      tags:
        - Translation
      summary: Translation Stream
      description: Translate text with Server-Sent Events (SSE) streaming response.
      operationId: translationStream
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - text
                - target_language
              properties:
                text:
                  type: string
                target_language:
                  type: string
                source_language:
                  type: string
                model_name:
                  type: string
                prompt_name:
                  type: string
                prompt_version:
                  type: string
      responses:
        '200':
          description: SSE stream started
          content:
            text/event-stream:
              schema:
                type: string
        '401':
          description: Unauthorized
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication

````