Language Detection

Language detection enables us to determine the language in which a given audio is uploaded. It is useful in case an audio whose source language is unknown needs to be transcribed. In such a case, first the language is determined and then results for transcription as well as all the other features are obtained.

File Transcription Job with Language Detection

API

Copy and paste the below curl request on your terminal to start a transcription using the API. Fill the variables with the appropriate values, as mentioned in the overview.

curl --location 'https://voice.neuralspace.ai/api/v1/jobs' \
--header 'Authorization: {{API_KEY}}' \
--form 'files=@"{{LOCAL_AUDIO_FILE_PATH}}"' \
--form 'config="{\"file_transcription\":{\"mode\":\"{{MODE}}\"}}"'

In the above request, the language_id parameter has not been passed as the language of the audio is not known. It also returns a response similar to the regular file transcription API as seen in overview.

{
    "success": true,
    "message": "Job created successfully",
    "data": {
        "jobId": "281f8662-cdc3-4c76-82d0-e7d14af52c46"
    }
}

Python SDK

Once installation steps for the package are complete, execute the below mentioned python code snippet:

import neuralspace as ns

vai = ns.VoiceAI()
# or,
# vai = ns.VoiceAI(api_key='YOUR_API_KEY')

# Setup job configuration
config = {
    "file_transcription": {
        "mode": {MODE},
    },
}

# Create a new file transcription job
job_id = vai.transcribe(file='path/to/audio.wav', config=config)
print(job_id)

Here, the language_id parameter has not been passed as the language of the audio is not known. The other parameters are similar to those mentioned in the overview page. The response looks similar as well:

6abe4f35-8220-4981-95c7-3b040d9b86d1

Fetch Transcription and Language Detection Results

API

When you pass the jobId (received in response to the transcription API) to the API below, it fetches the status and results of the job.

curl --location 'https://voice.neuralspace.ai/api/v1/jobs/{{jobId}}' \
--header 'Authorization: {{API_KEY}}'

Python SDK

Using the jobId (received in response to the transcription API) the snippet below can be executed to fetch the status and results of the job.

result = vai.get_job_status(jobId) 
print(result)

The response of the request above appears as follows:

{
    ...
    "data": {
        ...
        "result": {
            "language_detection": {
                "predicted_language_code": "en",
                "confidence": 0.7811065912246704
            },
            ...
        }
    }
}

In the response, the predicted language code is returned as well as the confidence that the model has for the prediction. The rest of the transcription and features work as expected and provide responses in otherwise the same format.

Troubleshooting and FAQ

Undetected? Check out our FAQ page. If you still need help, feel free to reach out to us directly at support@neuralspace.ai or join our Slack community.