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

# Get Models

> Retrieve a list of all available voice synthesis models

Retrieve a list of all available voice synthesis models.

## Authentication

Requires API key authentication via `x-api-key` header.

## Response

Returns an array of model objects.

### Response Schema

Each model object contains:

| Field         | Type           | Description                        |
| ------------- | -------------- | ---------------------------------- |
| `id`          | string (UUID)  | Unique identifier for the model    |
| `model_id`    | string         | Model identifier used in API calls |
| `model_name`  | string         | Human-readable model name          |
| `description` | string \| null | Detailed description of the model  |

### Example Request

```bash theme={null}
curl -X GET "https://api.munsit.com/api/v1/models" \
  -H "x-api-key: YOUR_API_KEY"
```

### Example Response

```json theme={null}
[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "model_id": "faseeh-v1-preview",
    "model_name": "Faseeh v1 Preview",
    "description": "High-quality Arabic voice synthesis supporting multiple dialects"
  },
  {
    "id": "123e4567-e89b-12d3-a456-426614174001",
    "model_id": "faseeh-mini-v1-preview",
    "model_name": "Faseeh v1 Mini Preview",
    "description": "Fast Arabic voice synthesis with lower latency"
  }
]
```

## Usage

Use the `model_id` from the response in text-to-speech generation endpoints:

* `POST /text-to-speech/:model_id` - HTTP endpoint
* `WS /text-to-speech` - WebSocket endpoint (include `model_id` in initConnection message)

<Note>
  **Caching**: Model information doesn't change frequently. Consider caching the model list to reduce API calls.
</Note>


## OpenAPI

````yaml GET /models
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:
  /models:
    get:
      tags:
        - Models
      summary: Get Models
      description: Retrieve a list of all available voice synthesis models
      operationId: getModels
      responses:
        '200':
          description: List of available models
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Model'
        '401':
          description: Unauthorized - Invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Too Many Requests - Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Model:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier for the model
        model_id:
          type: string
          description: Model identifier used in API calls
        model_name:
          type: string
          description: Human-readable model name
        description:
          type: string
          nullable: true
          description: Detailed description of the model
      required:
        - id
        - model_id
        - model_name
    Error:
      type: object
      required:
        - errorCode
        - errorMessage
      properties:
        errorCode:
          type: string
          description: Error code identifier
        errorMessage:
          type: string
          description: Human-readable error message
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication

````