Using the Pre-recorded API

The pre-recorded API allows you to transcribe audio files that are stored on the internet or on your local machine. You can find more details about the pre-recorded API in the official documentation.

Initialize the Deepgram Client

You'll need to initialize the DeepgramClient with your API key. If desired, you can provide your own custom logger which will be helpful for debugging. By default, all clients use a NullLogger. Here's how you can do it:
```
var client = new DeepgramClient("your-api-key", myCustomLogger);
```
Use the Pre-recorded API

Now you can use the DeepgramPrerecordedApi class to interact with the pre-recorded API. As with all other API methods, use can pass a cancellation token to the method to cancel the operation. Here's an example of how you can do this:
```
var result = await client.PreRecordedApi.TranscribeAsync("url-to-your-audio-file", myCancellationToken);
```
This will transcribe the audio file at the given url and return the result. Alternatively you can provide the audio file as a Stream object. Here's an example:
```
var prerecordedApi = new DeepgramPrerecordedApi(client);
var result = await prerecordedApi.Transcribe(File.OpenRead("path-to-your-audio-file"));
```
Using a custom model

By default, the pre-recorded API uses the general model. You can use a custom model by passing the model name within the DeepgramPrerecordedApiOptions object. Within the library are some default models that you can use for reference, but you can also use your own custom models. Here's an example of how you can do this:
```
var options = new DeepgramPrerecordedApiOptions
{
    Tier = Nova2Tier.FullName, // Alternatively "my-custom-model"
    Language = CultureInfo.GetCultureInfoByIetfLanguageTag("en-US"),
    Punctuate = true
};
```
Handle the Result

The Transcribe method returns a nullable DeepgramTranscription object. The transcription will contain metadata about the model used, the same amount of audio channels as the input data and most importantly, the recorded text. Here's an example of how you can handle the result:
```
if (result is not null)
{
    Console.WriteLine(result.Text);
}
```

Please replace "your-api-key" and "path-to-your-audio-file" with your actual API key and the path to your audio file.

Table of Contents

Using the Pre-recorded API