Transcribe long files

Upload file

First we upload the file with the transcribe_file_async() function. Once the request succeeds, the auto-assigned file_id is returned.

from soniox.speech_service import SpeechClient
from soniox.transcribe_file import transcribe_file_async


# Do not forget to set your API key in the SONIOX_API_KEY environment variable.
with SpeechClient() as client:
    file_id = transcribe_file_async(
        "../test_data/test_audio_long.flac",
        client,
        model="en_v2", # Do not forget to specify the model!
        reference_name="test",
    )

You can use the reference_name to associate your internal file id with the uploaded file. It can be any string not longer than 256 characters, including the empty string, and duplicates are allowed. The service does not use this field, it is only for your reference.

Get status

After the file has been uploaded, it will be in one of 4 states: QUEUED, TRANSCRIBING, COMPLETED or FAILED. We call the GetTranscribeAsyncStatus() function to check the status of the file.

status = client.GetTranscribeAsyncStatus(file_id)

If the file status is FAILED, the error message can be obtained from error_message field.

print(f"Transcription failed with error: {status.error_message}")

Get result

Once the file status is COMPLETED, we call the GetTranscribeAsyncResult() function to retrieve transcription result.

result = client.GetTranscribeAsyncResult(file_id)
print(f"Text: " + "".join(word.text for word in result.words))

Note, when transcribing with separate recognition per channel, the GetTranscribeAsyncResult() function returns a list of results, one for each channel.

Delete file

Once the transcription result has been obtained, the file should be deleted using DeleteTranscribeAsyncFile function.

client.DeleteTranscribeAsyncFile(file_id)

Upload file

First we upload the file with the transcribeFileAsync() function. Once the request succeeds, the auto-assigned file_id is returned.

// Do not forget to set your API key in the SONIOX_API_KEY environment variable.
const speechClient = new SpeechClient();

const file_id = await speechClient.transcribeFileAsync(
    "../test_data/test_audio_long.flac",
    "test", // reference_name
    {
        model: "en_v2", // Do not forget to specify the model!
    }
);

You can use the reference_name to associate your internal file id with the uploaded file. It can be any string not longer than 256 characters, including the empty string, and duplicates are allowed. The service does not use this field, it is only for your reference.

Get status

After the file has been uploaded, it will be in one of 4 states: QUEUED, TRANSCRIBING, COMPLETED or FAILED. We call the getTranscribeAsyncStatus() function to check the status of the file.

const response = await speechClient.getTranscribeAsyncStatus(file_id);

If the file status is FAILED, the error message can be obtained from error_message field.

console.log(`Transcription failed with error: ${response.error_message}`);

Get result

Once the file status is COMPLETED, we call the GetTranscribeAsyncResult() function to retrieve transcription result.

const result = await speechClient.getTranscribeAsyncResult(file_id);
console.log("Text: " + result.words.map((word) => word.text).join(""));

Note, when transcribing with separate recognition per channel, the GetTranscribeAsyncResult() function returns a list of results, one for each channel.

Delete file

Once the transcription result has been obtained, the file should be deleted using DeleteTranscribeAsyncFile function.

await speechClient.deleteTranscribeAsyncFile(file_id);

Upload file

First we upload the file with the transcribeFileAsync() function. Once the request succeeds, the auto-assigned file_id is returned.

// Do not forget to set your API key in the SONIOX_API_KEY environment variable.
using var client = new SpeechClient();

var fileId = await client.TranscribeFileAsync(
    "../../test_data/test_audio_long.flac",
    new TranscriptionConfig
    {
        Model = "en_v2", // Do not forget to specify the model!
        ClientRequestReference = "test",
    });

You can use the TranscriptionConfig.ClientRequestReference to associate your internal file id with the uploaded file. It can be any string not longer than 32 characters, including the empty string, and duplicates are allowed. The service does not use this field, it is only for your reference.

Get status

After the file has been uploaded, it will be in one of 4 states: QUEUED, TRANSCRIBING, :code:COMPLETED or :code:FAILED. We call the GetTranscribeAsyncFileStatus() function to check the status of the file.

TranscribeAsyncFileStatus status;
status = await client.GetTranscribeAsyncFileStatus(fileId);

If the file status is FAILED, the error message can be obtained from status.ErrorMessage field.

Console.WriteLine($"Transcription failed with error: {status.ErrorMessage}");

Get result

Once the file status is COMPLETED, we call the GetTranscribeAsyncResult() function to retrieve transcription result.

var completeResult = await client.GetTranscribeAsyncResult(fileId);
Result result = (completeResult as SingleResult)!.Result;
var text = string.Join("", result.Words.Select(word => word.Text).ToArray());
Console.WriteLine("Text: " + text);

When transcribing without separate recognition per channel, the GetTranscribeAsyncResult() function returns a SingleResult object, which has a single Result in the Result field. When transcribing with separate recognition per channel, it returns a SeparateRecognitionResult object, which has a list of Result objects in the ChannelResults field, one for each channel.

Delete file

Once the transcription result has been obtained, the file should be deleted using DeleteTranscribeAsyncFile function.

await client.DeleteTranscribeAsyncFile(fileId);