# ARES (/en/ai/models/asr/ares)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

Adaptive Recognition Engine for Speech (ARES) provides built-in real-time speech-to-text, offering seamless integration with low latency and reliable performance for conversational AI applications.

<CalloutContainer type="info">
  <CalloutTitle>
    Info
  </CalloutTitle>

  <CalloutDescription>
    Using Ares ASR incurs charges under the "ARES ASR Task" pricing category. See the [pricing](../../reference/pricing) page for details.
  </CalloutDescription>
</CalloutContainer>

### Sample configuration [#sample-configuration]

The following example shows how to configure ARES ASR when starting a conversational AI agent.

<Tabs defaultValue="python" groupId="ai-sdk-language">
  <TabsList>
    <TabsTrigger value="python">
      Python SDK
    </TabsTrigger>

    <TabsTrigger value="typescript">
      TypeScript SDK
    </TabsTrigger>

    <TabsTrigger value="go">
      Go SDK
    </TabsTrigger>

    <TabsTrigger value="rest-api">
      REST API
    </TabsTrigger>
  </TabsList>

  <TabsContent value="python">
    ```python
    from agora_agent import Agent, AresSTT

    # client is your configured Agora client
    agent = (
        Agent(client)
        .with_stt(AresSTT(
            language='en-US',
        ))
        .with_llm(...)  # configure your LLM vendor
        .with_tts(...)  # configure your TTS vendor
    )
    ```
  </TabsContent>

  <TabsContent value="typescript">
    ```typescript
    import { Agent, AresSTT } from 'agora-agents';

    // client is your configured Agora client
    const agent = new Agent({ client })
      .withStt(new AresSTT({
        language: 'en-US',
      }))
      .withLlm(/* configure your LLM vendor */)
      .withTts(/* configure your TTS vendor */);
    ```
  </TabsContent>

  <TabsContent value="go">
    ```go
    import "github.com/AgoraIO/agora-agents-go/v2/agentkit/vendors"

    // client is your configured Agora client
    agent := agentkit.NewAgent(client).WithStt(
        vendors.NewAresSTT(vendors.AresSTTOptions{
            Language: "en-US",
        }),
    ).WithLlm(/* configure your LLM vendor */).
      WithTts(/* configure your TTS vendor */)
    ```
  </TabsContent>

  <TabsContent value="rest-api">
    Use the following `asr` configuration in your request:

    ```json
    "asr": {
      "vendor": "ares",
      "language": "en-US"
    }
    ```
  </TabsContent>
</Tabs>

### Key parameters [#key-parameters]

<ParameterList title="asr" required="true">
  <Parameter name="vendor" type="string" required="true">
    ASR provider. Set to `ares` to use Adaptive Recognition Engine for Speech.
  </Parameter>

  <Parameter name="language" type="string" required="true" possibleValues="ar-EG, ar-JO, ar-SA, ar-AE, bn-IN, zh-CN, zh-HK, zh-TW, nl-NL, en-IN, en-US, fil-PH, fr-FR, de-DE, gu-IN, he-IL, hi-IN, id-ID, it-IT, ja-JP, kn-IN, ko-KR, ms-MY, fa-IR, pt-PT, ru-RU, es-ES, ta-IN, te-IN, th-TH, tr-TR, vi-VN">
    The BCP-47 language tag identifying the primary language used for agent interaction.
  </Parameter>
</ParameterList>