Setup your development environment

Learn how to update your docs locally and and deploy them to the public.

Get your API Key

First, you’ll need to authenticate your requests. You can get your API key from the VerbalisAI Dashboard.

1

Sign up or log in

Create an account at www.verbalisai.com/dashboard/overview or log in if you already have one

2

Navigate to API Keys

Go to the API Keys section in your dashboard

3

Create new API Key

Click “Create New Key” and give it a descriptive name

4

Copy your key

Copy the generated API key - you won’t be able to see it again!

Keep your API key secure and never expose it in client-side code. Always use environment variables or secure configuration management.

Make your first API call

Here’s how to transcribe your first audio file:

curl -X POST https://api.verbalisai.com/v1/transcript \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@/path/to/your/audio.mp3"

Understanding the Response

A successful transcription response will look like this:

{
  "success": true,
  "data": {
    "id": "trans_1234567890",
    "text": "Hello, this is a sample transcription of your audio file.",
    "confidence": 0.95,
    "language": "en",
    "duration": 12.5,
    "created_at": "2024-01-15T10:30:00Z",
    "sentences": [
      {
        "text": "Hello, this is a sample transcription of your audio file.",
        "start": 0.0,
        "end": 12.5,
        "confidence": 0.95
      }
    ]
  }
}

Supported Audio Formats

VerbalisAI supports a wide range of audio formats:

Next Steps

Now that you’ve made your first API call, explore more advanced features: