Quickstart

Get up and running with aiOla’s Speech AI in under 5 minutes. This guide will walk you through your first speech-to-text transcription using our SDKs.

What you’ll build

In this quickstart, you’ll transcribe an audio file into text using aiOla’s Speech-to-Text API. By the end, you’ll have a working example that you can expand upon.

Step 1: Get your API key

First, you’ll need an aiOla API key. If you don’t have one yet, sign up for an account to get started.

Step 2: Install the SDK

Choose your preferred language and install the aiOla SDK:

$
pip install aiola

Step 3: Set up authentication

Create a new file and set up authentication with your API key:

1
from aiola import AiolaClient
2
3
# Generate access token from your API key
4
result = AiolaClient.grant_token(api_key='your-api-key-here')
5
access_token = result['accessToken']
6
7
# Create the client
8
client = AiolaClient(access_token=access_token)

Step 4: Transcribe your first audio file

Now let’s transcribe an audio file. Make sure you have an audio file ready (supported formats: WAV, MP3, FLAC, and others):

1
# Open and transcribe an audio file
2
with open('path/to/your/audio.wav', 'rb') as audio_file:
3
    transcript = client.stt.transcribe_file(
4
        file=audio_file,
5
        language='en'
6
    )
7
8
# Print the transcription
9
print("Transcription:", transcript)

Step 5: Run your code

Save your file and run it:

$
python your_script.py

You should see the transcription of your audio file printed to the console!

Complete example

Here’s the complete working example:

1
from aiola import AiolaClient
2
3
# Step 1: Set up authentication
4
result = AiolaClient.grant_token(api_key='your-api-key-here')
5
access_token = result['accessToken']
6
client = AiolaClient(access_token=access_token)
7
8
# Step 2: Transcribe audio file
9
try:
10
    with open('path/to/your/audio.wav', 'rb') as audio_file:
11
        transcript = client.stt.transcribe_file(
12
            file=audio_file,
13
            language='en'
14
        )
15
    
16
    print("Transcription:", transcript)
17
    
18
except Exception as e:
19
    print(f"Error: {e}")

What’s next?

Congratulations! You’ve successfully transcribed your first audio file with aiOla. Here’s what you can explore next:

Core Features

SDKs & Resources

Browser Examples

Building a web application? Check out our complete browser example:

• Browser Microphone Streaming - Full web app showing real-time microphone transcription in the browser

Need help?

• Check out our detailed guides for more advanced use cases
• Browse the SDK repositories for additional examples
• Join our developer community for support and discussions

Ready to build something amazing with speech AI?