Get Transcriber Config

Get transcriber configuration

curl --request GET \
  --url https://api.inya.ai/platform/v1/agents/config/transcriber_config \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.inya.ai/platform/v1/agents/config/transcriber_config', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "status": "success",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "Transcriber config retrieved successfully",
  "response": {
    "transcriberConfig": [
      {
        "name": "Gnani",
        "provider": {
          "providerId": "gnani",
          "label": "Gnani",
          "description": "Purpose-built for Indian languages and accents."
        },
        "models": [
          {
            "modelId": "gnani_vachana_rest",
            "label": "Vachana Rest",
            "supportedLanguages": [
              "hi-IN",
              "en-IN",
              "te-IN",
              "ta-IN"
            ],
            "isMultilingual": true,
            "modelTier": "balanced"
          }
        ]
      },
      {
        "name": "Microsoft",
        "provider": {
          "providerId": "microsoft",
          "label": "Microsoft",
          "description": "Strong accuracy for English and international languages."
        },
        "models": [
          {
            "modelId": "microsoft_streaming",
            "label": "Streaming",
            "supportedLanguages": [
              "en-IN",
              "hi-IN",
              "en-US"
            ],
            "isMultilingual": true,
            "modelTier": "responsive"
          }
        ]
      }
    ]
  }
}

{
  "status": "failure",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "<string>"
}

{
  "status": "failure",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "<string>"
}

GET

agents

config

transcriber_config

Get transcriber configuration

curl --request GET \
  --url https://api.inya.ai/platform/v1/agents/config/transcriber_config \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.inya.ai/platform/v1/agents/config/transcriber_config', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "status": "success",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "Transcriber config retrieved successfully",
  "response": {
    "transcriberConfig": [
      {
        "name": "Gnani",
        "provider": {
          "providerId": "gnani",
          "label": "Gnani",
          "description": "Purpose-built for Indian languages and accents."
        },
        "models": [
          {
            "modelId": "gnani_vachana_rest",
            "label": "Vachana Rest",
            "supportedLanguages": [
              "hi-IN",
              "en-IN",
              "te-IN",
              "ta-IN"
            ],
            "isMultilingual": true,
            "modelTier": "balanced"
          }
        ]
      },
      {
        "name": "Microsoft",
        "provider": {
          "providerId": "microsoft",
          "label": "Microsoft",
          "description": "Strong accuracy for English and international languages."
        },
        "models": [
          {
            "modelId": "microsoft_streaming",
            "label": "Streaming",
            "supportedLanguages": [
              "en-IN",
              "hi-IN",
              "en-US"
            ],
            "isMultilingual": true,
            "modelTier": "responsive"
          }
        ]
      }
    ]
  }
}

{
  "status": "failure",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "<string>"
}

{
  "status": "failure",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "<string>"
}

What it does: Retrieve available ASR (Automatic Speech Recognition) providers and their models, filtered by language. The transcriber is the agent’s “ears” — it converts the caller’s spoken audio into text for the LLM to process. Use this endpoint to identify which ASR models support the languages your agent is configured to use. The language parameter is required. For multilingual agents (up to 3 languages), pass all language codes together so only models that support every language in the combination are returned.

Required Permission

agents

Query Parameters

Name	Type	Required	Description
`language`	string	Yes	Filter by one or more language codes. Repeat this parameter for multiple languages (e.g. `?language=en-IN&language=hi-IN`). Returns only ASR models that support all specified languages.
`providerId`	string	No	Filter results to a specific ASR provider (e.g. `gnani`, `deepgram`).

Minimum working example

curl "https://api.inya.ai/platform/v1/agents/config/transcriber_config?language=en-IN" \
  -H "x-api-key: <your_api_key>"

Additional examples

Multilingual — filter by multiple languages

curl "https://api.inya.ai/platform/v1/agents/config/transcriber_config?language=en-IN&language=hi-IN" \
  -H "x-api-key: <your_api_key>"

Filter by language and provider

curl "https://api.inya.ai/platform/v1/agents/config/transcriber_config?language=en-IN&providerId=gnani" \
  -H "x-api-key: <your_api_key>"

Response

Success (200)

{
  "status": "success",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "Transcriber config retrieved successfully",
  "response": {
    "transcriberConfig": [
      {
        "name": "Gnani",
        "provider": {
          "providerId": "gnani",
          "label": "Gnani",
          "description": "Purpose-built for Indian languages and accents. Best for Indic and multilingual Indian agents."
        },
        "models": [
          {
            "modelId": "gnani_vachana_rest",
            "label": "Vachana Rest",
            "supportedLanguages": ["hi-IN", "en-IN", "te-IN", "ta-IN", "mr-IN", "bn-IN", "kn-IN", "ml-IN"],
            "isMultilingual": true,
            "modelTier": "balanced"
          },
          {
            "modelId": "gnani_v2",
            "label": "Vachana",
            "supportedLanguages": ["hi-IN", "en-IN", "te-IN", "ta-IN", "mr-IN", "bn-IN", "kn-IN", "ml-IN"],
            "isMultilingual": true,
            "modelTier": "custom"
          }
        ]
      },
      {
        "name": "Microsoft",
        "provider": {
          "providerId": "microsoft",
          "label": "Microsoft",
          "description": "Strong accuracy for English and international languages. Recommended for non-Indic agents."
        },
        "models": [
          {
            "modelId": "microsoft_rest",
            "label": "Rest",
            "supportedLanguages": ["en-IN", "hi-IN", "en-US", "ta-IN", "te-IN"],
            "isMultilingual": true,
            "modelTier": "balanced"
          },
          {
            "modelId": "microsoft_streaming",
            "label": "Streaming",
            "supportedLanguages": ["en-IN", "hi-IN", "en-US", "ta-IN", "te-IN"],
            "isMultilingual": true,
            "modelTier": "responsive"
          }
        ]
      }
    ]
  }
}

Errors

404 Not Found - No matching ASR configuration found

{
  "status": "failure",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "Transcriber config not found",
  "response": { "transcriberConfig": [] }
}

Response Fields

Field	Type	Description
`transcriberConfig[].name`	string	Human-readable provider display name.
`transcriberConfig[].provider.providerId`	string	ASR provider identifier. Use as the `provider` value in `asrParams` when updating an agent.
`transcriberConfig[].provider.label`	string	Human-readable provider label.
`transcriberConfig[].provider.description`	string	Brief description of the provider’s strengths and recommended use cases.
`transcriberConfig[].models[].modelId`	string	Model identifier. Use as the `model` value in `asrParams`.
`transcriberConfig[].models[].label`	string	Human-readable model display name.
`transcriberConfig[].models[].supportedLanguages`	string[]	BCP-47 language codes supported by this model.
`transcriberConfig[].models[].isMultilingual`	boolean	Whether this model can handle multiple languages in a single session.
`transcriberConfig[].models[].modelTier`	string	Performance tier of the model: `balanced`, `responsive`, or `custom`.

Use Cases

Identifying which ASR models support a specific language or language combination before configuring an agent
Filtering the transcription model list to only show compatible options in a configuration UI
Validating that your current ASR model still supports a new language you are adding to a multilingual agent
Cross-referencing with the Update Agent advanceSettings compatibility table to verify model-specific features

The provider.providerId and modelId values returned here map directly to the provider and model fields in the Update Agent asrParams object. Use them as-is.

The language parameter is required. Requests without at least one language value will return a 404 error. Obtain valid language codes from the Get Languages endpoint.

For multilingual agents, pass all language codes in a single request (e.g. ?language=en-IN&language=hi-IN). This ensures only models that support every language in the set are returned, preventing incompatible configurations.

Save the requestId from every response. You will need it if you contact Gnani support to trace a specific request.

Authorizations

x-api-key

string

header

required

API key with 'agents' permission

Query Parameters

language

string[]

required

Language codes to filter by. Repeat this parameter for multiple languages. Example: ?language=en-IN&language=hi-IN

providerId

string

Filter results to a specific ASR provider

Example:

"gnani"

Response

Transcriber config retrieved successfully

status

string

Example:

"success"

requestId

string

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

message

string

response

object

Getting Started

Agents API

Conversations API

Agent Config API

Agent FAQ API

Chat SDK API

Reference

Get Transcriber Config

Required Permission

Query Parameters

Minimum working example

Additional examples

Multilingual — filter by multiple languages

Filter by language and provider

Response

Success (200)

Errors

Response Fields

Use Cases

Authorizations

Query Parameters

Response

​Required Permission

​Query Parameters

​Minimum working example

​Additional examples

​Multilingual — filter by multiple languages

​Filter by language and provider

​Response

​Success (200)

​Errors

​Response Fields

​Use Cases

Authorizations

Query Parameters

Response

Required Permission

Query Parameters

Minimum working example

Additional examples

Multilingual — filter by multiple languages

Filter by language and provider

Response

Success (200)

Errors

Response Fields

Use Cases