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>"
}

Overview

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`).

Example cURL

Single Language

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

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"
          }
        ]
      }
    ]
  }
}

Error Responses

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 Inya 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

Overview

Required Permission

Query Parameters

Example cURL

Single Language

Multilingual — Filter by Multiple Languages

Filter by Language and Provider

Response

Success (200)

Error Responses

Response Fields

Use Cases

Authorizations

Query Parameters

Response

​Overview

​Required Permission

​Query Parameters

​Example cURL

​Single Language

​Multilingual — Filter by Multiple Languages

​Filter by Language and Provider

​Response

​Success (200)

​Error Responses

​Response Fields

​Use Cases

Authorizations

Query Parameters

Response

Overview

Required Permission

Query Parameters

Example cURL

Single Language

Multilingual — Filter by Multiple Languages

Filter by Language and Provider

Response

Success (200)

Error Responses

Response Fields

Use Cases