API Permission

The API Permission endpoint allows you to verify whether your API key has access to a specific feature and what constraints apply (languages, avatars, usage limits, validity period).

This endpoint is useful for validating permissions before making feature-specific API calls.

Endpoint

GET /api/api-permission?feature={feature_key}

Headers

x-api-key: YOUR_API_KEY

Query Parameters

The following query parameters are supported:

• feature (required) – Feature key you want to check permission for (e.g. ms_tts_w_vc)

Available Feature Keys

The following feature keys can be used with the API Permission endpoint. Use these values in the feature query parameter.

[
  "ms_stt",
  "ms_tts_w_vc",
  "ms_ttt",
  "stt",
  "tts",
  "tts_w_vc",
  "ttt",
  "vs",
  "vt",
  "vt_w_vc"
]

Example (curl)

curl --location 'https://api.narris.io/api/api-permission?feature=ms_tts_w_vc' \
--header 'x-api-key: YOUR_API_KEY'

Successful Response

If your API key has access to the requested feature, the API returns permission details including allowed languages, avatars, usage limits, and validity.

{
  "feature": "ms_tts_w_vc",
  "input_languages": ["english", "hindi"],
  "output_languages": ["english", "hindi"],
  "avatars": ["daaji", "rahul"],
  "usage_limit": 10000,
  "usage_limit_unit": "characters",
  "start_date": "2024-01-01T00:00:00.000Z",
  "end_date": "2024-12-31T23:59:59.000Z",
  "active": true
}

Error Response

If your API key does not have access to the requested feature, the API returns a 403 Forbidden error.

{
  "message": "Access denied for feature: Multi Speaker Text to Speech (Voice Cloning)"
}