Skip to main content
GET
/
models
Get Models
curl --request GET \
  --url https://api.faseeh.ai/api/v1/models \
  --header 'x-api-key: <api-key>'
[
  {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "model_id": "<string>",
    "model_name": "<string>",
    "cost": 123,
    "description": "<string>"
  }
]
Retrieve a list of all available voice synthesis models.

​
Endpoint

GET /models

​
Authentication

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

​
Response

Returns an array of model objects.

​
Response Schema

Each model object contains:
FieldTypeDescription
idstring (UUID)Unique identifier for the model
model_idstringModel identifier used in API calls
model_namestringHuman-readable model name
costnumberCost per character for text-to-speech generation
descriptionstring | nullDetailed description of the model

​
Example Request

curl -X GET "https://api.faseeh.ai/api/v1/models" \
  -H "x-api-key: YOUR_API_KEY"

​
Example Response

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "model_id": "faseeh-arabic-v1",
    "model_name": "Faseeh Arabic v1",
    "cost": 0.0001,
    "description": "High-quality Arabic voice synthesis supporting multiple dialects"
  },
  {
    "id": "123e4567-e89b-12d3-a456-426614174001",
    "model_id": "faseeh-arabic-fast",
    "model_name": "Faseeh Arabic Fast",
    "cost": 0.00005,
    "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)
Caching: Model information doesn’t change frequently. Consider caching the model list to reduce API calls.

Authorizations

​
x-api-key
string
header
required

API key for authentication

Response

List of available models

​
id
string<uuid>
required

Unique identifier for the model

​
model_id
string
required

Model identifier used in API calls

​
model_name
string
required

Human-readable model name

​
cost
number
required

Cost per character for text-to-speech generation

​
description
string | null

Detailed description of the model